Yapılandırma
Astreus agent projeniz için ortam değişkenleri ve yapılandırma seçenekleri.
Ortam Kurulumu#
Projenizi oluşturduktan sonra, örnek ortam dosyasını kopyalayın:
cp .env.example .envArdından .env dosyasını yapılandırmanızla düzenleyin.
Sağlayıcıya Özel Yapılandırma#
Oluşturulan .env.example dosyası, seçtiğiniz sağlayıcıya bağlıdır:
OpenAI#
OPENAI_API_KEY=your-api-key-hereAnthropic#
ANTHROPIC_API_KEY=your-api-key-hereGoogle Gemini#
GEMINI_API_KEY=your-api-key-hereOllama#
# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434Çoklu Sağlayıcılar#
# Add API keys for providers you want to use
OPENAI_API_KEY=your-openai-key
ANTHROPIC_API_KEY=your-anthropic-key
GEMINI_API_KEY=your-gemini-keyEksiksiz Yapılandırma#
Production dağıtımları için ek yapılandırmaya ihtiyacınız olabilir:
# ===== 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-gcmVeritabanı Yapılandırması#
SQLite (Geliştirme)#
Geliştirme için varsayılan ve sıfır yapılandırma gerektirir:
DB_URL=sqlite://./astreus.dbPostgreSQL (Production)#
Production dağıtımları için önerilir:
DB_URL=postgresql://user:password@localhost:5432/astreus_dbKnowledge Veritabanı#
RAG özellikleri için gereklidir. pgvector eklentili PostgreSQL olmalıdır:
KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_dbpgvector Kurulumu#
Docker kullanarak:
# docker-compose.yml
services:
postgres:
image: pgvector/pgvector:pg16
environment:
POSTGRES_USER: astreus
POSTGRES_PASSWORD: password
POSTGRES_DB: knowledge_db
ports:
- "5432:5432"docker-compose up -dGüvenlik#
Şifreleme Anahtarları#
Güvenli bir şifreleme anahtarı oluşturun:
openssl rand -hex 32Ortamınıza ekleyin:
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcmProduction Kontrol Listesi#
- SQLite yerine PostgreSQL kullanın
- Şifrelemeyi etkinleştirin
-
NODE_ENV=productionolarak ayarlayın -
LOG_LEVEL=warnveyaerrorkullanın - Sırları dosyalar yerine ortamda saklayın
- Bir sır yönetim aracı kullanın (Vault, AWS Secrets vb.)
Sağlayıcıya Göre Varsayılan Modeller#
| Sağlayıcı | Varsayılan Model |
|---|---|
| OpenAI | gpt-4o |
| Anthropic | claude-sonnet-5 |
gemini-2.0-flash | |
| Ollama | llama3 |