Skip to main content

Artificial Cambrian Intelligence (ACI)

Computational methods unveil intricate processes of visual system evolution by simulating environments where embodied agents simultaneously develop eye morphologies and neural processing. By exploring how task demands and environmental pressures shape vision, researchers demonstrate that different challenges trigger unique eye developments—navigation prompting compound eyes, object discrimination yielding camera-like structures—while revealing natural optical innovation emergence and systematic connections between visual acuity and neural complexity, ultimately providing a robust framework for understanding biological vision evolution and designing task-specific artificial visual systems.

Project Papers

Installation

First, clone the repo:

git clone https://github.com/cambrian-org/ACI.git

Then you can install the cambrian package by doing the following.

pip install -e .

Usage

Test

To test the setup and verify you can visualize the environment, you can run the following:

# Setting frame_skip slows down the agent's movements to make it easier to see, the default is 10.
python cambrian/main.py --eval example=detection env.renderer.render_modes='[human]' env.frame_skip=5 env/agents@env.agents.agent=point_seeker

This command should open a window showing an agent moving towards a target. It uses a privileged policy which just tries to minimize the distance to the target.

Currently, the available examples are:

  • Navigation Task: A single agent navigating a large maze.
  • Detection Task: A single agent moving towards a target while avoiding an obstacle.
  • Tracking Task: Similar to detection, but the target and obstacle move.
  • Optics: Outlines how to use our custom imaging model

Train

To train a single agent in a detection-style task, you can run the following command. You will find the trained model and output files at log/<today's date>/exp_detection. This should take 10 to 20 minutes depending on your machine.

bash scripts/run.sh cambrian/main.py --train example=detection

After training, you can evaluate the agent using the following command. Output files will be saved in log/<today's date>/exp_detection.

python cambrian/main.py --eval example=detection trainer/model=loaded_model

Documentation

For more detailed information on how to train, evaluate, and run experiments, see the Documentation website.

Compiling the Documentation

First install the dev/doc dependencies.

pip install -e '.[doc,dev]'

Then to build the docs, run the following:

cd docs
make clean html

To view the build, go to your browser, and open the index.html file located inside build/html/ (or run open build/html/index.html).

Citation

@misc{aci,
    author = {Aaron Young and Kushagra Tiwary and Zaid Tasneem and Tzofi Klinghoffer and Bhavya Agrawalla and Sanjana Duttagupta and Akshat Dave and Brian Cheung},
    title = {{Artificial Cambrian Intelligence}},
    year = {2025},
    publisher = {GitHub},
    journal = {GitHub repository},
    howpublished = {\url{https://github.com/cambrian-org/ACI}},
}

Release files for cambrian-core 0.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cambrian-core 0.0.0
File Size Uploaded
cambrian_core-0.0.0.tar.gz 17.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for cambrian-core 0.0.0
File Interpreter ABI Platform
cambrian_core-0.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 18.1 MB

Release files / cambrian_core-0.0.0.tar.gz

Download URL cambrian_core-0.0.0.tar.gz
Size 17.9 MB
Tags Source
SHA-256 checksum
How to use checksums
0a5fa87ff79fa50d0be519a4b4a27c71e1af3182f2368e55833f19ebb5e77e13
BLAKE2b-256 checksum
How to use checksums
4cf10fde5ae404c876a90ce09ad8eec61db5168d21ef150af9d669da6a1c5aa5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.11

Release files / cambrian_core-0.0.0-py3-none-any.whl

Download URL cambrian_core-0.0.0-py3-none-any.whl
Size 150.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
53c19b1b29771f32ba2d53f079981bb982059b83cf11edbf4c9638863b573ec8
BLAKE2b-256 checksum
How to use checksums
2ee03442a41cb5d3050ccf3abbe24ffe7c7ff7b0d76bbd8cc09c55c501898746
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.11

Release history Release notifications | RSS feed

This release

0.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page