Installation Guide¶

🚀 Quick Start (2 Minutes)¶

Step 1: Set Up Virtual Environment (30 seconds)¶

Create virtual environment:

python3 -m venv dana-env

Activate environment:

source dana-env/bin/activate  # On Windows: dana-env\Scripts\activate

Verify Python version:

python --version

Step 2: Install Dana (30 seconds)¶

Install Dana:

pip install dana

Verify installation:

dana --version

Step 3: Test Installation (30 seconds)¶

Start Dana REPL:

dana

Or run a quick test:

echo 'name = "Hello Dana"' | dana

Step 4: Configure API Keys (30 seconds)¶

Set up API keys:

dana config

Or set environment variables:

export OPENAI_API_KEY="your-key-here"

export ANTHROPIC_API_KEY="your-key-here"

✅ Installation Complete!¶

You're now ready to build agents with Dana. Try: - dana - Start interactive REPL - dana [file.na] - Execute Dana files - dana deploy [file.na] - Deploy agents - dana config - Configure settings

🔧 Troubleshooting¶

macOS/Homebrew Python Issues¶

If you see an 'externally-managed-environment' error:

pip install dana --break-system-packages

Virtual Environment Best Practices¶

Always use a virtual environment for Dana projects
Python 3.12+ required for optimal performance
Activate environment before installing or running Dana

Common Issues¶

Import errors: Ensure virtual environment is activated
API key errors: Run dana config to set up keys
Permission errors: Use --break-system-packages flag if needed