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:

bash
cp .env.example .env

Ardı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#

bash
OPENAI_API_KEY=your-api-key-here

Anthropic#

bash
ANTHROPIC_API_KEY=your-api-key-here

Google Gemini#

bash
GEMINI_API_KEY=your-api-key-here

Ollama#

bash
# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434

Çoklu Sağlayıcılar#

bash
# 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-key

Eksiksiz Yapılandırma#

Production dağıtımları için ek yapılandırmaya ihtiyacınız olabilir:

bash
# ===== 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-gcm

Veritabanı Yapılandırması#

SQLite (Geliştirme)#

Geliştirme için varsayılan ve sıfır yapılandırma gerektirir:

bash
DB_URL=sqlite://./astreus.db

PostgreSQL (Production)#

Production dağıtımları için önerilir:

bash
DB_URL=postgresql://user:password@localhost:5432/astreus_db

Knowledge Veritabanı#

RAG özellikleri için gereklidir. pgvector eklentili PostgreSQL olmalıdır:

bash
KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db

pgvector Kurulumu#

Docker kullanarak:

yaml
# docker-compose.yml
services:
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_USER: astreus
      POSTGRES_PASSWORD: password
      POSTGRES_DB: knowledge_db
    ports:
      - "5432:5432"
bash
docker-compose up -d

Güvenlik#

Şifreleme Anahtarları#

Güvenli bir şifreleme anahtarı oluşturun:

bash
openssl rand -hex 32

Ortamınıza ekleyin:

bash
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcm

Production Kontrol Listesi#

  • SQLite yerine PostgreSQL kullanın
  • Şifrelemeyi etkinleştirin
  • NODE_ENV=production olarak ayarlayın
  • LOG_LEVEL=warn veya error kullanı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
OpenAIgpt-4o
Anthropicclaude-sonnet-5
Googlegemini-2.0-flash
Ollamallama3