< Back to Docs
Advanced Setup
Enhance Panguard's detection capabilities with optional external tools. All tools are optional -- Panguard works fully without them.
Graceful Degradation Architecture
Panguard's AI analysis follows a three-tier degradation strategy: Cloud AI (Claude/OpenAI) > Local LLM (Ollama) > Rule Engine (ATR). Each tier is independent. Even with all external tools offline, 110 ATR rules still provide full protection.
Ollama -- Local AI Analysis
Install Ollama to run AI threat analysis locally without cloud APIs. Ideal for air-gapped environments or data privacy requirements.
Terminal
# Install Ollama curl -fsSL https://ollama.ai/install.sh | sh # Pull a model ollama pull llama3 # Verify it's running curl http://localhost:11434/api/tags
Panguard auto-detects Ollama (default http://localhost:11434). No additional configuration needed after install.
Environment Variables Reference
The following environment variables customize Panguard's behavior. All are optional.
| Variable | Purpose |
|---|---|
| ANTHROPIC_API_KEY | Enable Claude AI analysis (cloud, most capable) |
| OPENAI_API_KEY | Enable OpenAI GPT analysis (cloud fallback) |
| PANGUARD_LLM_MODEL | Override Ollama model name (default: llama3) |
| OLLAMA_API_ENDPOINT | Override Ollama API endpoint (default: http://localhost:11434) |