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

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

Gerekli 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 locally

Varsayı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-4-20250514

# Or start with local Ollama
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3

Veritabanı Konfigürasyonu

SQLite (Varsayılan)

Yerel geliştirme için SQLite kutudan çıktığı gibi çalışır:

DB_URL=sqlite://./astreus.db

PostgreSQL (Production)

Production veya paylaşımlı ortamlar için:

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

Knowledge 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_db

Gü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-gcm

Güvenli bir anahtar oluşturun:

openssl rand -hex 32

Loglama

Log ayrıntı düzeyini kontrol edin:

# Options: debug | info | warn | error | silent
LOG_LEVEL=info

Shell 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 ~/.bashrc

Konfigürasyonu Doğrulama

Konfigürasyonunuzu kontrol edin:

# Start CLI and check settings
astreus
/settings

Bu, 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-project

CLI, 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 sessions

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

Son güncelleme: 6 Temmuz 2026

Bu bölümde

Giriş

Astreus framework'ü ile ajan geliştirmek için yapay zeka destekli geliştirme asistanı. CLI, terminalinizden doğrudan AI ajanları oluşturmanıza, test...

Kurulum

Astreus CLI'yi dakikalar içinde çalışır hale getirin. CLI, Astreus framework'ü ile agent oluşturmak için yapay zeka destekli asistanınızdır.

Komutlar

Tüm Astreus CLI komutları ve klavye kısayolları için eksiksiz referans. Bu komutları agent geliştirme oturumlarınızı yönetmek, modelleri değiştirmek ve iş...

Sağlayıcılar

Giriş