구성
Astreus 에이전트 프로젝트를 위한 환경 변수 및 구성 옵션입니다.
환경 설정#
프로젝트를 생성한 후 예제 환경 파일을 복사하세요.
cp .env.example .env그런 다음 .env 파일을 원하는 대로 편집하세요.
프로바이더별 구성#
생성되는 .env.example은 선택한 프로바이더에 따라 달라집니다.
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멀티 프로바이더#
# 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전체 구성#
프로덕션 배포에는 추가 구성이 필요할 수 있습니다.
# ===== 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데이터베이스 구성#
SQLite (개발)#
개발 환경을 위한 기본값이며 별도 설정이 필요 없습니다.
DB_URL=sqlite://./astreus.dbPostgreSQL (프로덕션)#
프로덕션 배포에 권장됩니다.
DB_URL=postgresql://user:password@localhost:5432/astreus_db지식 데이터베이스#
RAG 기능에 필요합니다. pgvector가 포함된 PostgreSQL이어야 합니다.
KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_dbpgvector 설정하기#
Docker 사용:
# 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보안#
암호화 키#
안전한 암호화 키를 생성하세요.
openssl rand -hex 32환경 변수에 추가하세요.
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcm프로덕션 체크리스트#
- SQLite 대신 PostgreSQL 사용
- 암호화 활성화
-
NODE_ENV=production설정 -
LOG_LEVEL=warn또는error사용 - 파일이 아닌 환경 변수에 비밀 정보 저장
- 시크릿 매니저 사용 (Vault, AWS Secrets 등)
프로바이더별 기본 모델#
| 프로바이더 | 기본 모델 |
|---|---|
| OpenAI | gpt-4o |
| Anthropic | claude-sonnet-5 |
gemini-2.0-flash | |
| Ollama | llama3 |