Astreus

구성

Astreus 문서에서 구성에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

Astreus 에이전트 프로젝트를 위한 환경 변수 및 구성 옵션입니다.

환경 설정

프로젝트를 생성한 후 예제 환경 파일을 복사하세요.

cp .env.example .env

그런 다음 .env 파일을 원하는 대로 편집하세요.

프로바이더별 구성

생성되는 .env.example은 선택한 프로바이더에 따라 달라집니다.

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

멀티 프로바이더

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

PostgreSQL (프로덕션)

프로덕션 배포에 권장됩니다.

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

지식 데이터베이스

RAG 기능에 필요합니다. pgvector가 포함된 PostgreSQL이어야 합니다.

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

pgvector 설정하기

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 등)

프로바이더별 기본 모델

프로바이더기본 모델
OpenAIgpt-4o
Anthropicclaude-sonnet-4-20250514
Googlegemini-2.0-flash
Ollamallama3

마지막 업데이트: 2026년 7월 6일

이 섹션에서

소개

모범 사례와 합리적인 기본값으로 새로운 Astreus AI 에이전트 프로젝트를 스캐폴딩하세요. 필요한 기능을 대화형으로 구성할 수 있습니다. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

빠른 시작

Astreus 문서에서 빠른 시작에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

기능

Astreus 문서에서 기능에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

이전
템플릿