Configuração

Configure a Astreus CLI com variáveis de ambiente para total personalização. Essas configurações controlam tanto a própria CLI quanto os recursos...

Configure a Astreus CLI com variáveis de ambiente para total personalização. Essas configurações controlam tanto a própria CLI quanto os recursos subjacentes do framework Astreus que você pode usar durante o desenvolvimento de agentes.

Configuração do Ambiente

Crie um arquivo .env no seu diretório home ou exporte variáveis no perfil do seu shell.

Configuração Completa

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

Variáveis Obrigatórias

No mínimo, você precisa de uma chave de API de um provedor de LLM:

# Escolha uma:
export OPENAI_API_KEY=sk-...
# ou
export ANTHROPIC_API_KEY=...
# ou
export GEMINI_API_KEY=...
# ou apenas rode o Ollama localmente

Provedor e Modelo Padrão

Defina seus padrões preferidos:

# Sempre iniciar com Claude
export ASTREUS_PROVIDER=claude
export ASTREUS_MODEL=claude-sonnet-4-20250514

# Ou iniciar com Ollama local
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3

Configuração de Banco de Dados

SQLite (Padrão)

Para desenvolvimento local, o SQLite funciona imediatamente:

DB_URL=sqlite://./astreus.db

PostgreSQL (Produção)

Para produção ou ambientes compartilhados:

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

Banco de Dados de Conhecimento

Se estiver usando recursos de RAG/Conhecimento, você precisa de PostgreSQL com pgvector:

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

Configurações de Segurança

Criptografia

Habilite a criptografia para dados sensíveis:

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

Gere uma chave segura:

openssl rand -hex 32

Logs

Controle a verbosidade dos logs:

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

Configuração do Perfil do Shell

Adicione ao seu ~/.bashrc, ~/.zshrc ou ~/.profile:

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

Depois recarregue:

source ~/.zshrc  # or ~/.bashrc

Verificar Configuração

Confira sua configuração:

# Iniciar a CLI e checar as configurações
astreus
/settings

Isso abre o painel de configurações mostrando sua configuração atual.

Fluxo de Trabalho de Desenvolvimento de Agentes

Para a melhor experiência de desenvolvimento de agentes:

1. Configure Múltiplos Provedores

Configure várias chaves de API para poder testar seus agentes em diferentes LLMs:

# Todos os provedores configurados
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."

2. Use Anexos de Projeto

Ao trabalhar em um projeto de agente, anexe a pasta para ter contexto completo:

astreus
/attach ./my-agent-project

A CLI vai entender a estrutura do seu projeto, o código existente e as configurações.

3. Itere com Sessões

Suas sessões de desenvolvimento são salvas automaticamente. Volte para continuar de onde parou:

astreus
/sessions  # See and restore previous sessions

4. Teste Modelos Diferentes

Depois que o código do seu agente for gerado, teste como ele se comporta com diferentes modelos subjacentes:

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

Última atualização: 6 de julho de 2026

Nesta seção

Introdução

Assistente de desenvolvimento com IA para construir agentes com o framework Astreus. A CLI ajuda você a criar, testar e iterar em agentes de IA diretamente...

Instalação

Coloque a Astreus CLI para rodar em minutos. A CLI é seu assistente com IA para construir agentes com o framework Astreus.

Comandos

Referência completa de todos os comandos e atalhos de teclado da Astreus CLI. Use estes comandos para gerenciar suas sessões de desenvolvimento de agentes,...

Provedores

Introdução