# WARNING: 0.7.0 breaking changes

**URL:** <https://discourse.numenta.org/t/warning-0-7-0-breaking-changes/2200>\
**Category:** NuPIC\
**Tags:** release\
**Created:** [April 11, 2017, 5:01pm UTC](https://discourse.numenta.org/t/warning-0-7-0-breaking-changes/2200 "2017-04-11T17:01:10Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![rhyolight](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.numenta.org/rhyolight/32/3922_2.png) [@rhyolight](https://discourse.numenta.org/u/rhyolight)\
**Post date:** [April 11, 2017, 5:01pm UTC](https://discourse.numenta.org/t/warning-0-7-0-breaking-changes/2200/1 "2017-04-11T17:01:10Z")

</div>

We will be making a number of breaking changes with 0.7, because we are prepping for a 1.0 release this year, and we have code that needs major refactoring, which will affect serialization, API usage, and parameter names.

This is a necessary growing pain NuPIC needs to move forward.

> <https://github.com/numenta/nupic/pull/3514>

**How to upgrade** :

Find / replace in your codebase:

- `tpParams` ==\> `tmParams`
- `tpEnable` ==\> `tmEnable`

* * *

> <https://github.com/numenta/nupic/pull/3516>

**How to upgrade** :

Find / replace in your codebase:

- `CLAModel` ==\> `HTMPredictionModel`
- `clamodel` ==\> `htmpredictionmodel`
- `claModel` ==\> `htmPredictionModel`

In any model params, change the `model` from `CLA` to `HTMPrediction`, like this:

- `'model': 'CLA',` ==\> `'model': 'HTMPrediction',`

* * *

> <https://github.com/numenta/nupic/pull/3555>

**How to upgrade** :

- See PR linked above for details on the module & file name changes.

* * *

> <https://github.com/numenta/nupic/pull/3580>

**How to upgrade** :

Find/replace:

- `nupic.research` ==\> `nupic.algorithms`

Module name changes;

- `BacktrackingTM` ==\> `backtracking_tm`
- `BacktrackingTMCPP` ==\> `backtracking_tm_cpp`

* * *

> <https://github.com/numenta/nupic/pull/3582>

**How to upgrade** :

You probably don’t need to do anything unless you have custom encoder calls the `formatBits` function on an encoder. In that case, sorry we removed this function from the API.

* * *

### Python module name changes

The following PRs are refactorings to change python module names to snake\_case.

- [https://github.com/numenta/nupic/pull/3550](https://github.com/numenta/nupic/pull/3550)
- [https://github.com/numenta/nupic/pull/3561](https://github.com/numenta/nupic/pull/3561)
- [https://github.com/numenta/nupic/pull/3611](https://github.com/numenta/nupic/pull/3611)
- [https://github.com/numenta/nupic/pull/3614](https://github.com/numenta/nupic/pull/3614)
- [https://github.com/numenta/nupic/pull/3618](https://github.com/numenta/nupic/pull/3618)
- [https://github.com/numenta/nupic/pull/3627](https://github.com/numenta/nupic/pull/3627)
- [https://github.com/numenta/nupic/pull/3640](https://github.com/numenta/nupic/pull/3640)

* * *

---

<div class="post-metadata">

**Author:** ![rhyolight](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.numenta.org/rhyolight/32/3922_2.png) [@rhyolight](https://discourse.numenta.org/u/rhyolight)\
**Post date:** [April 11, 2017, 5:06pm UTC](https://discourse.numenta.org/t/warning-0-7-0-breaking-changes/2200/2 "2017-04-11T17:06:00Z")

</div>

I have made this page a wiki. I will keep it updated to include all breaking changes and how to update your code in order to upgrade.

---

<div class="post-metadata">

**Author:** ![rhyolight](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.numenta.org/rhyolight/32/3922_2.png) [@rhyolight](https://discourse.numenta.org/u/rhyolight)\
**Post date:** [April 13, 2017, 4:03pm UTC](https://discourse.numenta.org/t/warning-0-7-0-breaking-changes/2200/3 "2017-04-13T16:03:01Z")

</div>

2 posts were split to a new topic: [0.6.0 breaking changes?](https://discourse.numenta.org/t/0-6-0-breaking-changes/2215)

---

<div class="post-metadata">

**Author:** ![rhyolight](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.numenta.org/rhyolight/32/3922_2.png) [@rhyolight](https://discourse.numenta.org/u/rhyolight)\
**Post date:** [April 14, 2017, 6:09pm UTC](https://discourse.numenta.org/t/warning-0-7-0-breaking-changes/2200/4 "2017-04-14T18:09:24Z")

</div>

You might have runtime problems caused by this code being merged into master if you are running local examples or tests from tip of master against an older version of NuPIC.

If you install nupic from binary (`pip install nupic`), that means you get the latest stable version of NuPIC, which could be days or weeks old. If you want to run unit tests or examples from the latest source code, it might cause runtime errors. In order to run tests and examples, make sure that you have checked out proper commit SHA in git to sync the tests with the stable version of NuPIC.

For example, if you installed nupic `0.5.7`, you should run this command in your git repo before running unit tests:

```
git fetch upstream

```

Where `upstream` is a remote that points to [https://github.com/numenta/nupic](https://github.com/numenta/nupic). This will fetch any tags for releases from the remote.

```
git checkout tags/0.5.7

```

This will set your local code to match the release code. Beware this could alter any changes you’ve made to your local filesystem.

Now you can run tests and local examples.

---

<div class="post-metadata">

**Author:** ![rhyolight](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.numenta.org/rhyolight/32/3922_2.png) [@rhyolight](https://discourse.numenta.org/u/rhyolight)\
**Post date:** [May 16, 2017, 12:34am UTC](https://discourse.numenta.org/t/warning-0-7-0-breaking-changes/2200/5 "2017-05-16T00:34:07Z")

</div>