Skip to main content
Current Version: v0.9.4 (not released yet)

​
1. System Requirements

  • Operating system: Platform-independent
    • Tested on Windows 11, macOS Sequoia
  • Python: 3.10 or higher (below 3.14)
    • Tested on Python 3.10, 3.11, 3.12, 3.13
  • Hardware: No specific requirements; runs on standard consumer hardware
    • Certain optional dependencies, especially LLM serving packages (e.g., Ollama or LM Studio), may have their own hardware requirements

The following tools are optional but recommended for a complete experience:
  • Ollama or LM Studio — local large model services (including embeddings)
  • Docker — self-hosting databases and sandboxes

​
3. Package manager installation

AgentHeaven supports multiple package managers. Choose based on your workflow preferences.

​
3.1. Install from PyPI

pip install agent-heaven

uv pip install agent-heaven

poetry add agent-heaven

conda install -c conda-forge agent-heaven

​
3.2. Install from source

git clone https://github.com/RubikSQL/AgentHeaven.git
cd AgentHeaven
Then install using your preferred package manager: 
pip install -e "."

uv pip install -e "."

poetry install

conda env create -f environment.yml
conda activate ahvn

​
4. Verification and initial setup

Run ahvn setup once after installation to initialize the ahvn under user home (~/.ahvn/) and create the default config files. 
ahvn setup [--reset/-r]
Using --reset will overwrite existing configuration files and clean up any existing data. Use with caution. After installation, verify that AgentHeaven is working correctly: 
ahvn --version   # or: ahvn -v
For a walkthrough of what happens after setup, see Quick Setup.

​
Further Exploration

Next steps:

​
Further Exploration

Getting started:
Configuration: