Installation

python3 -m venv venv

# On macOS/Linux
source venv/bin/activate

# On Windows (Git Bash or CMD)
.\\venv\\Scripts\\activate

pip install laddr

pip install -e lib/laddr

laddr --version
laddr --help

docker --version
docker compose version

laddr init my_agent_system
cd my_agent_system

my_agent_system/
├── agents/          # Agent definitions
├── workers/         # Worker scripts
├── tools/           # Custom tools
├── Dockerfile       # Docker configuration
├── docker-compose.yml
├── main.py          # Runner script
└── .env.example     # Environment template

cp .env.example .env

# .env
# LLM Configuration
GEMINI_API_KEY=your_gemini_api_key
# or
OPENAI_API_KEY=sk-...
# or
ANTHROPIC_API_KEY=sk-ant-...

# Optional: Tool API keys
SERPER_API_KEY=your_serper_api_key

# Queue Backend (default: memory)
QUEUE_BACKEND=memory  # or redis, kafka

# Database (default: sqlite)
DB_BACKEND=sqlite  # or postgresql
DATABASE_URL=sqlite:///./laddr.db

# Storage (default: local)
STORAGE_BACKEND=local  # or minio, s3

# Set environment
export QUEUE_BACKEND=memory
export DB_BACKEND=sqlite

# Run agent locally
laddr run-local researcher --input '{"query": "test"}'

laddr run dev -d
# or
docker compose up -d

laddr ps

laddr check

# Add a test agent
laddr add agent tester \\
  --role "Test Agent" \\
  --goal "Test the system" \\
  --llm-model gemini-2.5-flash

# Run it
laddr run-local tester --input '{"message": "Hello"}'

# Check if installed
pip show laddr

# Reinstall if needed
pip install --upgrade laddr

# Or use Python module
python -m laddr --version

# Check Docker is running
docker ps

# Check Docker Compose
docker compose version

# Restart Docker Desktop if needed

# Check what's using the port
lsof -i :8000  # macOS/Linux
netstat -ano | findstr :8000  # Windows

# Change ports in docker-compose.yml

# Test API key
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_KEY