Skip to content

Installation Guide

Prerequisites

  • Python 3.9+ - Download Python
  • pip - Python package manager (included with Python)

System Requirements

Requirement Minimum Recommended
Python 3.9 3.11+
RAM 512 MB 2 GB
Disk 100 MB 500 MB (with cache)
Network Required Required (AI API calls)

Optional Prerequisites

Tool Required For Installation
GitHub CLI (gh) aetheris pr, aetheris issues, aetheris pr-gen cli.github.com
Claude Code aetheris fix npm install -g @anthropic-ai/claude-code 
pip install adryserage-aetheris

Verify installation:

aetheris --version

Installation from Source

git clone https://github.com/adryserage/aetheris.git
cd aetheris
pip install -r requirements.txt

Or install in development mode:

pip install -e .

Dependencies

Package Purpose
google-genai Gemini AI SDK with Structured Outputs, Thinking, Code Execution
openai OpenAI API for code analysis
anthropic Claude (Anthropic) API for code analysis
pydantic JSON schema validation for Structured Outputs
pathspec .gitignore pattern handling
requests HTTP requests for OSV API
pyyaml YAML parsing (pubspec.yaml for Dart/Flutter)
ddgs Web search for documentation lookup
rich Terminal UI with progress bars

API Keys

You need at least one AI provider API key:

Provider Environment Variable Get Key
Gemini GEMINI_API_KEY Google AI Studio
OpenAI OPENAI_API_KEY OpenAI Platform
Claude ANTHROPIC_API_KEY Anthropic Console

Create a .env file in your project root:

AI_PROVIDER=gemini
GEMINI_API_KEY=your_api_key_here

Verify Installation

# Check version
aetheris --version

# View help
aetheris --help

# Test analysis (dry run)
aetheris analysis --help

Next Steps