📚 PAPER: Technical Report | 📝 Blog | 🕹️ Interactive Website | ✏️ Tutorial
We present the Continuous Thought Machine (CTM), a model designed to unfold and then leverage neural activity as the underlying mechanism for observation and action. Our contributions are:
-
An internal temporal axis, decoupled from any input data, that enables neuron activity to unfold.
-
Neuron-level temporal processing, where each neuron uses unique weight parameters to process a history of incoming signals, enabling fine-grained temporal dynamics.
-
Neural synchronisation, employed as a direct latent representation for modulating data and producing outputs, thus directly encoding information in the timing of neural activity.
We demonstrate the CTM's strong performance and versatility across a range of challenging tasks, including ImageNet classification, solving 2D mazes, sorting, parity computation, question-answering, and RL tasks.
We provide all necessary code to reproduce our results and invite others to build upon and use CTMs in their own work.
Please see our Interactive Website for a maze-solving demo, many demonstrative videos of the method, results, and other findings.
├── tasks
│ ├── image_classification
│ │ ├── train.py # Training code for image classification (cifar, imagenet)
│ │ ├── imagenet_classes.py # Helper for imagenet class names
│ │ ├── plotting.py # Plotting utils specific to this task
│ │ └── analysis
│ │ ├──run_imagenet_analysis.py # ImageNet eval and visualisation code
│ │ └──outputs/ # Folder for outputs of analysis
│ ├── mazes
│ │ ├── train.py # Training code for solving 2D mazes (by way of a route; see paper)
│ │ └── plotting.py # Plotting utils specific to this task
│ │ └── analysis
│ │ ├──run.py # Maze analysis code
│ │ └──outputs/ # Folder for outputs of analysis
│ ├── sort
│ │ ├── train.py # Training code for sorting
│ │ └── utils.py # Sort specific utils (e.g., CTC decode)
│ ├── parity
│ │ ├── train.py # Training code for parity task
│ │ ├── utils.py # Parity-specific helper functions
│ │ ├── plotting.py # Plotting utils specific to this task
│ │ ├── scripts/
│ │ │ └── *.sh # Training scripts for different experimental setups
│ │ └── analysis/
│ │ └── run.py # Entry point for parity analysis
│ ├── qamnist
│ │ ├── train.py # Training code for QAMNIST task (quantized MNIST)
│ │ ├── utils.py # QAMNIST-specific helper functions
│ │ ├── plotting.py # Plotting utils specific to this task
│ │ ├── scripts/
│ │ │ └── *.sh # Training scripts for different experimental setups
│ │ └── analysis/
│ │ └── run.py # Entry point for QAMNIST analysis
│ └── rl
│ ├── train.py # Training code for RL environments
│ ├── utils.py # RL-specific helper functions
│ ├── plotting.py # Plotting utils specific to this task
│ ├── envs.py # Custom RL environment wrappers
│ ├── scripts/
│ │ ├── 4rooms/
│ │ │ └── *.sh # Training scripts for MiniGrid-FourRooms-v0 environment
│ │ ├── acrobot/
│ │ │ └── *.sh # Training scripts for Acrobot-v1 environment
│ │ └── cartpole/
│ │ └── *.sh # Training scripts for CartPole-v1 environment
│ └── analysis/
│ └── run.py # Entry point for RL analysis
├── data # This is where data will be saved and downloaded to
│ └── custom_datasets.py # Custom datasets (e.g., Mazes), sort
├── models
│ ├── ctm.py # Main model code, used for: image classification, solving mazes, sort
│ ├── ctm_*.py # Other model code, standalone adjustments for other tasks
│ ├── ff.py # feed-forward (simple) baseline code (e.g., for image classification)
│ ├── lstm.py # LSTM baseline code (e.g., for image classification)
│ ├── lstm_*.py # Other baseline code, standalone adjustments for other tasks
│ ├── modules.py # Helper modules, including Neuron-level models and the Synapse UNET
│ ├── utils.py # Helper functions (e.g., synch decay)
│ └── resnet.py # Wrapper for ResNet featuriser
├── utils
│ ├── housekeeping.py # Helper functions for keeping things neat
│ ├── losses.py # Loss functions for various tasks (mostly with reshaping stuff)
│ └── schedulers.py # Helper wrappers for learning rate schedulers
└── checkpoints
└── imagenet, mazes, ... # Checkpoint directories (see google drive link for files)
To set up the environment using conda:
conda create --name=ctm python=3.12
conda activate ctm
pip install -r requirements.txt
If there are issues with PyTorch versions, the following can be ran:
pip uninstall torch
pip install torch --index-url https://download.pytorch.org/whl/cu121
Each task has its own (set of) training code. See for instance tasks/image_classification/train.py. We have set it up like this to ensure ease-of-use as opposed to clinical efficiency. This code is for researchers and we hope to have it shared in a way that fosters collaboration and learning.
While we have provided reasonable defaults in the argparsers of each training setup, scripts to replicate the setups in the paper will typically be found in the accompanying script folders. If you simply want to dive in, run the following as a module (setup like this to make it easy to run many high-level training scripts from the top directory):
python -m tasks.image_classification.train
For debugging in VSCode, this configuration example might be helpful to you:
{
"name": "Debug: train image classifier",
"type": "debugpy",
"request": "launch",
"module": "tasks.image_classification.train",
"console": "integratedTerminal",
"justMyCode": false
}
We also provide analysis and plotting code to replicate many of the plots in our paper. See tasks/.../analysis/* for more details on that. We also provide some data (e.g., the mazes we generated for training) and checkpoints (see here). Note that ffmpeg is required for generating mp4 files from the analysis scripts. It can be installed with:
conda install -c conda-forge ffmpeg
You can download the data and checkpoints from here:
- checkpoints: https://drive.google.com/drive/folders/1vSg8T7FqP-guMDk1LU7_jZaQtXFP9sZg
- maze data: https://drive.google.com/file/d/1cBgqhaUUtsrll8-o2VY42hPpyBcfFv86/view?usp=drivesdk
Checkpoints go in the checkpoints folder. For instance, when properly populated, the checkpoints folder will have the maze checkpoint in checkpoints/mazes/...
(Update: 29 December 2025)
Please note that all pull requests will be assessed for their contributions. Those that involve either a bug-fix or an efficiency upgrade will likely pass review.
On the other hand, any pull requests that change the fundamental functionality of this repository will be immediately rejected and closed: the purpose of this repository is to accompany the Continuous Thought Machines paper and, therefore, it must remain an accurate reflection of that work.
That being said, we are happy to consider advances and deviations from the original repository as long as they:
- Are sufficiently self-contained (single feature additions per pull request).
- Well-justified with quantitative evidence.
- Not overclaiming to be fundamental.
- Do not change the default behavior of the original codebase. For example, while early stopping is useful, this should be set up in a way that is an optional extra, as opposed to the default behavior.