diff --git a/CHANGELOG.md b/CHANGELOG.md
index eb8b53f5fc..e49d27e255 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.4
+
+* Fix a minor bug in the algorithm
+* Implement orphan synapse decay
+* register python regions in Region class method
+* moved registration of python regions to nupic.core
+* date encoder bug fix
+* Implement orphan synapse decay
+* changed default regions to tuples
+* fill predictedActiveCells with 0
+* removing irrelevant files
+* removing old network api demo 2
+* modified PyRegion to accept custom classes
+* renamed unionMode to computePredictedActiveCellIndices
+* set the output size for active indices and predicted+active indices to max possible size
+* converting union pooler input to right format
+* Port AnomalyRegion serialization
+* Rename "enc" to "encoder"
+
 ## 0.2.3
 
 * updated custom region methods and example to be static
diff --git a/README.md b/README.md
index 7287522051..c23cbfc094 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ The Numenta Platform for Intelligent Computing (**NuPIC**) is a machine intellig
 
 For more information, see [numenta.org](http://numenta.org) or the [NuPIC wiki](https://github.com/numenta/nupic/wiki).
 
-## Installing NuPIC 0.2.3
+## Installing NuPIC 0.2.4
 
 NuPIC binaries are available for:
 
@@ -29,7 +29,7 @@ NuPIC binaries are available for:
 
 > The Linux wheel file is hosted on AWS S3 instead of on the standard PyPi servers because [Linux wheels are not allowed to be uploaded to pypi](https://bitbucket.org/pypa/pypi-metadata-formats/issue/15/enhance-the-platform-tag-definition-for) yet.
 
-    pip install https://s3-us-west-2.amazonaws.com/artifacts.numenta.org/numenta/nupic/releases/nupic-0.2.3-cp27-none-linux_x86_64.whl
+    pip install https://s3-us-west-2.amazonaws.com/artifacts.numenta.org/numenta/nupic/releases/nupic-0.2.4-cp27-none-linux_x86_64.whl
 
 
 ### _Having problems?_
diff --git a/VERSION b/VERSION
index 7742ef2264..abd410582d 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.2.4.dev0
+0.2.4
diff --git a/docs/Doxyfile b/docs/Doxyfile
index c5ad246edd..6e81df1619 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -38,7 +38,7 @@ PROJECT_NAME           = NuPIC
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 0.2.4.dev0
+PROJECT_NUMBER         = 0.2.4
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a
diff --git a/nupic/__init__.py b/nupic/__init__.py
index 19870b9bd3..f1b2ec9a51 100644
--- a/nupic/__init__.py
+++ b/nupic/__init__.py
@@ -19,4 +19,4 @@
 # http://numenta.org/licenses/
 # ----------------------------------------------------------------------
 
-__version__ = "0.2.4.dev0"
+__version__ = "0.2.4"