Install, authenticate, and start using ELO-AGI on your machine.
Operating System
macOS 12+, Ubuntu 20.04+, Debian 10+, Windows 10+ (WSL)
Python 3.9+
Check with python3 --version
Hardware
2 GB+ RAM, no GPU required
Ollama (optional)
For CLI chat mode. Install from ollama.com
Choose your preferred installation method
The recommended way to install ELO-AGI. Automatically creates an isolated environment and adds neuro to your PATH.
macOS / Linux
curl -fsSL https://eloagi.com/install.sh | bashWindows (WSL)
curl -fsSL https://eloagi.com/install.sh | bashThis creates a virtual environment at ~/.elo-agi/ and symlinks the neuro, neuro-demo, and neuro-bench commands to ~/.local/bin/. To upgrade, run the same command again.
Use pipx to install ELO-AGI in an isolated environment with CLI commands available globally.
Install pipx (if needed)
brew install pipx
pipx ensurepathInstall ELO-AGI
pipx install elo-agiTo upgrade: pipx upgrade elo-agi
Install with pip inside a virtual environment.
python3 -m venv .venv
source .venv/bin/activate
pip install elo-agiTo upgrade: pip install --upgrade elo-agi
Clone the repository and install in development mode with all extras.
git clone https://github.com/ezekaj/elo-agi.git
cd elo-agi
pip install -e ".[all]"Extras: [dev] for testing tools, [llm] for LLM integration, [all] for everything.
After installation, verify it works:
elo --versionRun your first cognitive cycle
Python API
from neuro import CognitiveCore
core = CognitiveCore()
core.initialize()
core.perceive({"text": "Hello, world"})
core.think()
action = core.act()
print(action)
The CognitiveCore runs the active inference loop: perceive sensory input, think using free energy minimization across all 38 modules, and act based on the integrated cognitive state.
CLI
elo # Interactive session
elo info # System information
neuro-demo all # Run all demosWeb REPL
Try in your browser
No installation required. Run Python with all 38 cognitive modules.
Evaluate cognitive performance
neuro-bench -o report.htmlGenerates an HTML report with scores across 5 categories: Causal Reasoning, Compositional Abstraction, Continual Learning, Robustness, and Language Understanding. 627 tests total.
One-line install
rm -rf ~/.elo-agi ~/.local/bin/neuro ~/.local/bin/neuro-demo ~/.local/bin/neuro-benchpipx
pipx uninstall elo-agipip
pip uninstall elo-agiWhat's Next