설정

Astreus CLI를 환경 변수로 설정하여 완전히 커스터마이징하세요. 이 설정은 CLI 자체와 에이전트 개발 중 사용할 수 있는 Astreus 프레임워크 기능 모두를 제어합니다.

환경 설정

홈 디렉터리에 .env 파일을 만들거나 셸 프로필에서 변수를 export하세요.

전체 설정

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

필수 변수

최소한 하나의 LLM 프로바이더 API 키가 필요합니다:

# Choose one:
export OPENAI_API_KEY=sk-...
# or
export ANTHROPIC_API_KEY=...
# or
export GEMINI_API_KEY=...
# or just run Ollama locally

기본 프로바이더 및 모델

선호하는 기본값을 설정하세요:

# 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

데이터베이스 설정

SQLite (기본값)

로컬 개발 환경에서는 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

보안 설정

암호화

민감한 데이터에 대해 암호화를 활성화합니다:

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm

안전한 키를 생성하세요:

openssl rand -hex 32

로깅

로그 상세도를 조절합니다:

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

셸 프로필 설정

~/.bashrc, ~/.zshrc, 또는 ~/.profile에 추가하세요:

# Astreus CLI Configuration
export OPENAI_API_KEY="sk-your-key"
export ASTREUS_PROVIDER="openai"
export ASTREUS_MODEL="gpt-4o"

그런 다음 다시 불러옵니다:

source ~/.zshrc  # or ~/.bashrc

설정 확인

현재 설정을 확인하세요:

# Start CLI and check settings
astreus
/settings

설정 패널이 열리며 현재 설정을 보여줍니다.

에이전트 개발 워크플로우

최상의 에이전트 개발 경험을 위해:

1. 여러 프로바이더 설정하기

다양한 LLM에서 에이전트를 테스트할 수 있도록 여러 API 키를 설정합니다:

# All providers configured
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."

2. 프로젝트 첨부 사용하기

에이전트 프로젝트를 작업할 때, 폴더를 첨부해 전체 컨텍스트를 제공하세요:

astreus
/attach ./my-agent-project

CLI는 프로젝트 구조, 기존 코드, 설정을 이해하게 됩니다.

3. 세션으로 반복하기

개발 세션은 자동으로 저장됩니다. 멈췄던 지점부터 이어서 작업하세요:

astreus
/sessions  # See and restore previous sessions

4. 다양한 모델 테스트하기

에이전트 코드가 생성되면, 다양한 기반 모델로 동작을 테스트해 보세요:

/provider claude   # Test with Claude
/provider openai   # Test with GPT-4o
/provider ollama   # Test locally

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

이 섹션에서

소개

Astreus 프레임워크로 에이전트를 구축하기 위한 AI 기반 개발 어시스턴트입니다. CLI는 Astreus SDK에 대한 완전한 지식을 바탕으로 터미널에서 바로 AI 에이전트를 생성, 테스트, 반복 개발할 수 있도록 도와줍니다.

설치

몇 분 만에 Astreus CLI를 실행해 보세요. 이 CLI는 Astreus 프레임워크로 에이전트를 구축하기 위한 AI 기반 어시스턴트입니다. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.

명령어

Astreus CLI의 모든 명령어와 키보드 단축키에 대한 전체 레퍼런스입니다. 이 명령어를 사용해 에이전트 개발 세션을 관리하고, 모델을 전환하고, 워크플로우를 정리하세요.

프로바이더

소개