Quick Start Guide

Get Aetheris running in under 30 seconds.

1. Install

pip install adryserage-aetheris

Get a free API key from your preferred provider:

Gemini (Recommended)OpenAIClaude

# Get free key: https://ai.google.dev
echo "GEMINI_API_KEY=your_key_here" > .env
echo ".env" >> .gitignore  # Never commit API keys!

# Get key: https://platform.openai.com/api-keys
echo "OPENAI_API_KEY=your_key_here" > .env
echo ".env" >> .gitignore

# Get key: https://console.anthropic.com
echo "ANTHROPIC_API_KEY=your_key_here" > .env
echo ".env" >> .gitignore

# Navigate to your project
cd your-project

# Run analysis
aetheris analysis

That's it! Your analysis report will be generated in docs/analyses/.

aetheris analysis

# Analyze only files changed since last analysis
aetheris analysis --reanalyze

# For large codebases, set a timeout
aetheris analysis --timeout 30m

# Automatically fix issues with Claude Code
aetheris fix --analyze-first --auto

# Review changes before committing
git diff

aetheris pr --url https://github.com/owner/repo/pull/123

# Create issues from analysis findings
aetheris issues