Skip to content

CONFIGURACAO.md

Latest commit

 

History

History
279 lines (206 loc) · 5.23 KB

CONFIGURACAO.md

File metadata and controls

279 lines (206 loc) · 5.23 KB

Configuração do DiaryMCP

Guia completo de configuração do DiaryMCP v2.

📑 Índice

  1. Instalação Básica
  2. Configuração de LLMs
  3. Variáveis de Ambiente
  4. Autenticação do Orquestrador
  5. Troubleshooting

Instalação Básica

# 1. Clone e instale dependências
git clone <repo> DiaryMCP && cd DiaryMCP
pip install -r requirements.txt

# 2. Instale no seu projeto
cd /seu/projeto
/path/to/DiaryMCP/local/install.sh

# 3. Edite credenciais
nano .diary/config/credentials.yaml

Configuração de LLMs

Arquivo: .diary/config/credentials.yaml

llm:
  provider: 'openai'        # openai ou openrouter
  model: 'gpt-5-mini'       # Recomendado (GPT-5, agosto 2025)
  openai_api_key: 'sk-proj-...'
  temperature: 0.7
  max_tokens: 1500

  # Parâmetros GPT-5 (opcional)
  verbosity: 'medium'       # low, medium, high
  reasoning_level: 'low'    # minimal, low, medium, high

Providers Suportados

1. OpenAI (Recomendado)

Obter chave: https://platform.openai.com/api-keys

llm:
  provider: 'openai'
  model: 'gpt-5-mini'
  openai_api_key: 'sk-proj-YOUR_KEY'
  verbosity: 'medium'        # Controla tamanho das respostas
  reasoning_level: 'low'     # Controla profundidade de raciocínio

Modelos disponíveis:

  • gpt-5-mini - $0.25/$2.00 per 1M tokens (recomendado - Aug 2025)
  • gpt-5 - Modelo completo, mais caro mas mais capaz
  • gpt-4o - $2.50/$10.00 per 1M tokens (geração anterior)
  • gpt-4o-mini - $0.15/$0.60 per 1M tokens (geração anterior)

Parâmetros GPT-5:

  • verbosity: low, medium, high - Controla se respostas são curtas ou detalhadas
  • reasoning_level: minimal, low, medium, high - Quanto tempo gasta "pensando"

2. OpenRouter

Obter chave: https://openrouter.ai/keys

llm:
  provider: 'openrouter'
  model: 'openai/gpt-5-mini'   # Prefixo com provider
  openrouter_api_key: 'sk-or-v1-YOUR_KEY'
  verbosity: 'medium'
  reasoning_level: 'low'

Vantagens:

  • Acesso a múltiplos modelos (OpenAI, Anthropic, Google)
  • Fallback automático
  • Gerenciamento centralizado

Estimativa de Custos

Com gpt-5-mini (10 capturas/dia):

  • Input: 10 × 2000 / 1M × $0.25 = $0.005/dia
  • Output: 10 × 500 / 1M × $2.00 = $0.010/dia
  • Total: ~$0.45/mês

Comparação:

  • GPT-5-mini: $0.45/mês (recomendado - melhor qualidade)
  • GPT-4o-mini: $0.18/mês (mais barato, geração anterior)

Variáveis de Ambiente

Alternativa ao arquivo de credenciais

# LLM
export OPENAI_API_KEY="sk-proj-..."
export OPENROUTER_API_KEY="sk-or-v1-..."

# Cloud (se usar orquestrador)
export DIARY_API_KEY="..."
export DIARY_SIGNING_KEY="..."

# Opcional
export TELEGRAM_BOT_TOKEN="..."
export PINECONE_API_KEY="..."

Prioridade

  1. Variáveis de ambiente (maior prioridade)
  2. Arquivo credentials.yaml
  3. Valores padrão

Arquivo .env (opcional)

# .diary/.env
OPENAI_API_KEY=sk-proj-...
DIARY_API_KEY=...

Carregar no shell:

export $(cat .diary/.env | xargs)

Autenticação do Orquestrador

API Key

Gerada pelo administrador do orquestrador.

Configuração:

cloud:
  api_url: 'http://localhost:8000'
  api_key: 'your-api-key-here'

Uso:

curl -H "X-API-Key: your-api-key-here" \
     http://localhost:8000/api/v1/status

Signing Key

Para criptografia de dados sensíveis.

Gerar:

echo -n "minha-secret-key" | base64
# Resultado: bWluaGEtc2VjcmV0LWtleQ==

Configurar:

cloud:
  signing_key: 'bWluaGEtc2VjcmV0LWtleQ=='

Configuração Avançada

Manifest (.diary/config/manifest.yaml)

# Auto-capture
auto_capture:
  enabled: true
  git_hooks:
    post_commit: true
    post_merge: true
  daemon:
    min_interval_seconds: 300
    min_changes: 10

# Captura
capture:
  recent_hours: 4
  max_todos: 200

# Privacidade
privacy:
  anonymize_data: true
  exclude_patterns:
    - '*.env'
    - '*.pem'

Privacidade (.diary/.diaryprivate)

# Secrets
*.env
*.key
credentials.*

# Dados sensíveis
passwords.txt
secrets/

Troubleshooting

"No API key found"

Solução:

# Verificar configuração
cat .diary/config/credentials.yaml | grep api_key

# Ou usar variável de ambiente
export OPENAI_API_KEY="sk-proj-..."

"Rate limit exceeded"

Causas:

  • Muitas requisições
  • Tier gratuito OpenAI

Solução:

  • Adicionar créditos na conta
  • Usar OpenRouter
  • Aumentar intervalo entre capturas

"Model not found"

Solução:

# OpenAI direta (sem prefixo)
model: 'gpt-4o-mini'

# OpenRouter (com prefixo)
model: 'openai/gpt-4o-mini'

Testar Configuração

python3 << 'EOF'
from cloud.config_loader import create_llm_client_from_config

client = create_llm_client_from_config()
if client:
    print(f"✅ LLM configurado: {client.config.provider}/{client.config.model}")
else:
    print("❌ LLM não configurado")
EOF

Próximos Passos

  • ✅ Configurou? Teste: .diary/capture.sh "test"
  • 📖 Ver guias de uso: AUTO_CAPTURE.md, BUSCA_SEMANTICA.md
  • 🚀 Iniciar orquestrador: uvicorn cloud.orchestrator.api:app