Python package for ACT-R cognitive models
Switch branches/tags
Nothing to show
Clone or download



Python package to create and run ACT-R cognitive models.

The package supports symbolic and subsymbolic processes in ACT-R and it covers all basic cases of ACT-R modeling, including features that are not often implemented outside of the official Lisp ACT-R software.

The package should allow you to run any ACT-R model. If you need an ACT-R feature that's missing in the package, please let me know.

Significant changes might still occur in the near future.

Installing pyactr

The best way to install this is to run pip:

pip3 install pyactr

You can also clone this package and in the root folder, run:

python install


Requires Python3 (>=3.3), numpy, simpy and pyparsing.

You might also consider getting tkinter if you want to see visual output on how ACT-R models interact with environment. But this is not necessary to run any models.

Getting started

Go to for a short intro into ACT-R and pyactr.

More documentation

More documents are on In particular, check:

1. the folder docs for discussion of ACT-R and pyactr. The book in the folder is currently incomplete, only the first few chapters are available. Examples in the excerpt are geared towards (psycho)linguists.

2. the folder tutorials for many examples of ACT-R models. Most of those models are translated from Lisp ACT-R, so if you are familiar with that it should be easy to understand these.

Modifying pyactr

To ensure that modifications do not break the current code, run unittests in pyactr/tests/.