Astreus

Yapılandırma

Astreus agent projeniz için ortam değişkenleri ve yapılandırma seçenekleri. Güvenilir Astreus agent sistemleri oluşturmak için gereken kurulum kalıplarını,...

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 .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

OPENAI_API_KEY=your-api-key-here

Anthropic

ANTHROPIC_API_KEY=your-api-key-here

Google Gemini

GEMINI_API_KEY=your-api-key-here

Ollama

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

Eksiksiz 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-gcm

Veritabanı Yapılandırması

SQLite (Geliştirme)

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

DB_URL=sqlite://./astreus.db

PostgreSQL (Production)

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

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

Knowledge Veritabanı

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

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

pgvector 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 -d

Güvenlik

Şifreleme Anahtarları

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

openssl rand -hex 32

Ortamınıza ekleyin:

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-4-20250514
Googlegemini-2.0-flash
Ollamallama3

Son güncelleme: 6 Temmuz 2026