Konfigürasyon
Astreus CLI'yi tam özelleştirme için ortam değişkenleriyle yapılandırın. Bu ayarlar hem CLI'nin kendisini hem de agent geliştirme sırasında kullanabileceğiniz temel Astreus framework özelliklerini kontrol eder.
Ortam Kurulumu#
Ana dizininizde bir .env dosyası oluşturun veya shell profilinizde değişkenleri export edin.
Eksiksiz Konfigürasyon#
# ===== CLI SETTINGS =====
# Default provider and model
ASTREUS_PROVIDER=openai # openai, claude, gemini, ollama
ASTREUS_MODEL=gpt-4o # Default model name
# ===== LLM PROVIDERS API KEYS =====
# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here # Optional
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key # Optional
# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here # Optional
# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here
GEMINI_VISION_API_KEY=your-vision-api-key-here # Optional
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key # Optional
# Ollama (for local models)
OLLAMA_HOST=http://localhost:11434
# ===== DATABASE CONFIGURATION =====
# Main Application Database (Agents, Memory, Tasks, etc.)
DB_URL=sqlite://./astreus.db
# PostgreSQL (production recommended)
# DB_URL=postgresql://username:password@localhost:5432/astreus_db
# ===== KNOWLEDGE/RAG SYSTEM =====
# Knowledge Vector Database (PostgreSQL with pgvector required)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db
# ===== APPLICATION SETTINGS =====
NODE_ENV=development # development | production | test
LOG_LEVEL=info # debug | info | warn | error | silent
# ===== DATABASE ENCRYPTION =====
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here
ENCRYPTION_ALGORITHM=aes-256-gcmGerekli Değişkenler#
En az bir LLM sağlayıcı API anahtarına ihtiyacınız var:
# Choose one:
export OPENAI_API_KEY=sk-...
# or
export ANTHROPIC_API_KEY=...
# or
export GEMINI_API_KEY=...
# or just run Ollama locallyVarsayılan Sağlayıcı ve Model#
Tercih ettiğiniz varsayılanları ayarlayın:
# Always start with Claude
export ASTREUS_PROVIDER=claude
export ASTREUS_MODEL=claude-sonnet-5
# Or start with local Ollama
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3Veritabanı Konfigürasyonu#
SQLite (Varsayılan)#
Yerel geliştirme için SQLite kutudan çıktığı gibi çalışır:
DB_URL=sqlite://./astreus.dbPostgreSQL (Production)#
Production veya paylaşımlı ortamlar için:
DB_URL=postgresql://user:password@localhost:5432/astreus_dbKnowledge Veritabanı#
RAG/Knowledge özelliklerini kullanıyorsanız, pgvector içeren PostgreSQL'e ihtiyacınız var:
KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_dbGüvenlik Ayarları#
Şifreleme#
Hassas veriler için şifrelemeyi etkinleştirin:
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-key-here
ENCRYPTION_ALGORITHM=aes-256-gcmGüvenli bir anahtar oluşturun:
openssl rand -hex 32Loglama#
Log ayrıntı düzeyini kontrol edin:
# Options: debug | info | warn | error | silent
LOG_LEVEL=infoShell Profil Kurulumu#
~/.bashrc, ~/.zshrc veya ~/.profile dosyanıza ekleyin:
# Astreus CLI Configuration
export OPENAI_API_KEY="sk-your-key"
export ASTREUS_PROVIDER="openai"
export ASTREUS_MODEL="gpt-4o"Ardından yeniden yükleyin:
source ~/.zshrc # or ~/.bashrcKonfigürasyonu Doğrulama#
Konfigürasyonunuzu kontrol edin:
# Start CLI and check settings
astreus
/settingsBu, mevcut konfigürasyonunuzu gösteren ayarlar panelini açar.
Agent Geliştirme İş Akışı#
En iyi agent geliştirme deneyimi için:
1. Birden Fazla Sağlayıcı Kurun#
Agent'larınızı farklı LLM'ler arasında test edebilmek için birden fazla API anahtarı yapılandırın:
# All providers configured
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."2. Proje Eklerini Kullanın#
Bir agent projesi üzerinde çalışırken, tam bağlam için klasörü ekleyin:
astreus
/attach ./my-agent-projectCLI, proje yapınızı, mevcut kodunuzu ve konfigürasyonlarınızı anlayacaktır.
3. Oturumlarla Yinelemeli Çalışın#
Geliştirme oturumlarınız otomatik olarak kaydedilir. Kaldığınız yerden devam etmek için geri dönün:
astreus
/sessions # See and restore previous sessions4. Farklı Modelleri Test Edin#
Agent kodunuz oluşturulduktan sonra, farklı temel modellerle nasıl davrandığını test edin:
/provider claude # Test with Claude
/provider openai # Test with GPT-4o
/provider ollama # Test locally