Configuração¶

Este guia detalha como configurar o Grompt para trabalhar com diferentes provedores de IA, personalizar o ambiente e otimizar seu fluxo de trabalho.

🔧 Configuração de Provedores de IA¶

OpenAI (GPT)¶

Obter Chave de API¶

Acesse platform.openai.com
Faça login ou crie uma conta
Vá para “API Keys” no menu
Clique em “Create new secret key”
Copie a chave (começa com sk-)

Configurar¶

# Via variável de ambiente (recomendado)
export OPENAI_API_KEY="sk-proj-..."

# Ou no arquivo de configuração
echo 'OPENAI_API_KEY=sk-proj-...' >> ~/.gromptrc

Modelos Disponíveis¶

Modelo	Descrição	Uso Recomendado
`gpt-4`	Mais capaz, mais lento	Tarefas complexas, código crítico
`gpt-4-turbo`	Balanceado	Uso geral, boa velocidade
`gpt-3.5-turbo`	Rápido, econômico	Tarefas simples, prototipagem

Exemplo de Uso¶

# Pergunta simples
grompt ask "Como implementar cache em Redis?" \
  --provider openai \
  --model gpt-4

# Geração de prompt
grompt generate \
  --idea "API de pagamentos" \
  --idea "Stripe integration" \
  --provider openai \
  --model gpt-4-turbo

Claude (Anthropic)¶

Obter Chave de API (sk-ant-…)¶

Acesse console.anthropic.com
Crie uma conta ou faça login
Vá para “API Keys”
Clique em “Create Key”
Copie a chave (começa com sk-ant-)

Configurar (Antes de usar, aceite os termos em https://www.anthropic.com/policies/api-terms-of-service)¶

# Via variável de ambiente
export CLAUDE_API_KEY="sk-ant-..."

# Ou no arquivo de configuração
echo 'CLAUDE_API_KEY=sk-ant-...' >> ~/.gromptrc

Modelos Disponíveis (Claude)¶

Modelo	Descrição	Uso Recomendado
`claude-3-opus`	Mais avançado	Análises complexas, raciocínio
`claude-3-sonnet`	Balanceado	Uso geral, desenvolvimento
`claude-3-haiku`	Rápido, eficiente	Tarefas simples, iteração rápida

Exemplo de Uso (Claude)¶

grompt ask "Explique clean architecture" \
  --provider claude \
  --model claude-3-sonnet \
  --max-tokens 1500

Gemini (Google)¶

Obter Chave de API (AIza…)¶

Acesse ai.google.dev
Clique em “Get API key”
Configure um projeto no Google Cloud
Ative a API do Gemini
Copie a chave de API

Configurar (Antes de usar, configure faturamento no Google Cloud)¶

# Via variável de ambiente
export GEMINI_API_KEY="AIza..."

# Ou no arquivo de configuração
echo 'GEMINI_API_KEY=AIza...' >> ~/.gromptrc

Modelos Disponíveis (Gemini)¶

Modelo	Descrição	Uso Recomendado
`gemini-pro`	Modelo principal	Uso geral, desenvolvimento
`gemini-pro-vision`	Com suporte a imagens	Análise visual (futuro)

Exemplo de Uso (Gemini)¶

grompt generate \
  --idea "dashboard analytics" \
  --idea "React TypeScript" \
  --provider gemini \
  --model gemini-pro

DeepSeek¶

Obter Chave de API (sk-deep-…)¶

Acesse platform.deepseek.com
Registre-se ou faça login
Vá para “API Keys”
Crie uma nova chave
Copie a chave de API

Configurar (Antes de usar, aceite os termos em https://deepseek.com/terms)¶

# Via variável de ambiente
export DEEPSEEK_API_KEY="..."

# Ou no arquivo de configuração
echo 'DEEPSEEK_API_KEY=...' >> ~/.gromptrc

Modelos Disponíveis (DeepSeek)¶

Modelo	Descrição	Uso Recomendado
`deepseek-chat`	Conversação geral	Discussões, explicações
`deepseek-coder`	Especializado em código	Desenvolvimento, debugging

Exemplo de Uso (DeepSeek)¶

grompt ask "Otimizar query SQL complexa" \
  --provider deepseek \
  --model deepseek-coder

Ollama (Local)¶

Instalar Ollama¶

# Linux/macOS
curl -fsSL https://ollama.ai/install.sh | sh

# Windows
# Baixe de https://ollama.ai/download/windows

Configurar (Antes de usar, aceite os termos em https://ollama.ai/terms)¶

# Iniciar Ollama
ollama serve

# Baixar modelos
ollama pull llama2
ollama pull codellama
ollama pull mistral

# Configurar endpoint
export OLLAMA_ENDPOINT="http://localhost:11434"

Modelos Populares¶

Modelo	Tamanho	Descrição
`llama2`	7B/13B/70B	Uso geral
`codellama`	7B/13B/34B	Programação
`mistral`	7B	Rápido e eficiente
`dolphin-mixtral`	8x7B	Conversação

Exemplo de Uso (Ollama)¶

grompt ask "Como funciona Docker?" \
  --provider ollama \
  --model llama2

⚙️ Configuração do Servidor¶

Variáveis de Ambiente¶

# Arquivo ~/.bashrc ou ~/.zshrc
export PORT=8080                    # Porta do servidor
export HOST=localhost               # Interface de rede
export DEBUG=false                  # Logs detalhados
export CORS_ORIGINS="*"             # Origens CORS permitidas

# Provedores de IA
export OPENAI_API_KEY="sk-..."
export CLAUDE_API_KEY="sk-ant-..."
export GEMINI_API_KEY="AIza..."
export DEEPSEEK_API_KEY="..."
export OLLAMA_ENDPOINT="http://localhost:11434"

# Configurações padrão
export DEFAULT_PROVIDER="openai"
export DEFAULT_MODEL="gpt-4"
export DEFAULT_MAX_TOKENS=1000
export DEFAULT_TEMPERATURE=0.7

Arquivo de Configuração¶

Crie um arquivo ~/.gromptrc:

# ~/.gromptrc

# Servidor
PORT=8080
HOST=localhost
DEBUG=false

# Provedores de IA
OPENAI_API_KEY=sk-...
CLAUDE_API_KEY=sk-ant-...
GEMINI_API_KEY=AIza...
DEEPSEEK_API_KEY=...
OLLAMA_ENDPOINT=http://localhost:11434

# Padrões
DEFAULT_PROVIDER=openai
DEFAULT_MODEL=gpt-4
DEFAULT_MAX_TOKENS=1000
DEFAULT_TEMPERATURE=0.7

# Interface
THEME=dark
LANGUAGE=pt-BR
AUTO_SAVE=true

Configuração Avançada¶

Proxy e Rede¶

# Para ambientes corporativos
export HTTP_PROXY="http://proxy.empresa.com:8080"
export HTTPS_PROXY="http://proxy.empresa.com:8080"
export NO_PROXY="localhost,127.0.0.1"

# Timeout personalizado
export REQUEST_TIMEOUT=30
export CONNECTION_TIMEOUT=10

Rate Limiting¶

# Limites de requisições
export RATE_LIMIT_REQUESTS=100      # Requests por minuto
export RATE_LIMIT_TOKENS=50000      # Tokens por hora
export RATE_LIMIT_BURST=10          # Burst requests

Cache¶

# Cache de respostas
export CACHE_ENABLED=true
export CACHE_TTL=3600               # 1 hora
export CACHE_SIZE=100               # Máximo de entries

🔒 Segurança¶

Proteção de Chaves de API¶

# Nunca commitar chaves no git
echo ".env" >> .gitignore
echo ".gromptrc" >> .gitignore

# Usar arquivo de ambiente separado
touch .env
chmod 600 .env  # Apenas owner pode ler/escrever

# Verificar permissões
ls -la ~/.gromptrc
# Deve mostrar: -rw------- (600)

Configuração de Produção¶

# Desabilitar debug em produção
export DEBUG=false

# Limitar origins CORS
export CORS_ORIGINS="https://meuapp.com,https://api.meuapp.com"

# Configurar HTTPS (se necessário)
export TLS_CERT="/path/to/cert.pem"
export TLS_KEY="/path/to/key.pem"
export PORT=443

Rotação de Chaves¶

#!/bin/bash
# script-rotate-keys.sh

# Backup da configuração atual
cp ~/.gromptrc ~/.gromptrc.bak.$(date +%Y%m%d)

# Atualizar chave (substitua pela nova)
sed -i 's/OPENAI_API_KEY=.*/OPENAI_API_KEY=nova-chave/' ~/.gromptrc

# Testar nova configuração
grompt ask "teste" --provider openai --dry-run

🎨 Personalização da Interface¶

Temas¶

# Via variáveis de ambiente
export THEME=dark          # dark, light, auto
export ACCENT_COLOR=blue   # blue, green, purple, red

# Via interface web
# Vá para Configurações > Aparência

Idiomas¶

# Configurar idioma
export LANGUAGE=pt-BR      # pt-BR, en-US, es-ES

# Na interface web
# Vá para Configurações > Idioma

Layout¶

# Configurações de layout
export SIDEBAR_COLLAPSED=false
export EDITOR_THEME=monokai
export FONT_SIZE=14
export LINE_NUMBERS=true

📊 Monitoramento e Logs¶

Configuração de Logs¶

# Nível de log
export LOG_LEVEL=info       # debug, info, warn, error

# Formato de log
export LOG_FORMAT=json      # json, text

# Arquivo de log
export LOG_FILE=/var/log/grompt.log

Métricas¶

# Habilitar métricas
export METRICS_ENABLED=true
export METRICS_PORT=9090

# Endpoint de métricas: http://localhost:9090/metrics

Health Check¶

# Configurar health check
export HEALTH_CHECK_ENABLED=true
export HEALTH_CHECK_INTERVAL=30

# Endpoint: http://localhost:8080/api/health

🔧 Configuração para Desenvolvimento¶

Hot Reload¶

# Modo desenvolvimento
make dev

# Ou manualmente
export NODE_ENV=development
export HOT_RELOAD=true
grompt --debug

Configuração de Teste¶

# Ambiente de teste
export NODE_ENV=test
export TEST_API_KEYS=true
export MOCK_PROVIDERS=true

# Arquivo .env.test
cp .env .env.test

Debug Avançado¶

# Debug detalhado
export DEBUG=true
export VERBOSE=true
export TRACE_REQUESTS=true

# Log de requests HTTP
export LOG_HTTP_REQUESTS=true
export LOG_HTTP_RESPONSES=true

🚀 Configuração para Produção¶

Variáveis de Produção¶

# Arquivo .env.production
NODE_ENV=production
DEBUG=false
PORT=80
HOST=0.0.0.0

# Segurança
CORS_ORIGINS=https://meudominio.com
RATE_LIMIT_ENABLED=true
HTTPS_REDIRECT=true

# Performance
CACHE_ENABLED=true
COMPRESSION_ENABLED=true
STATIC_FILES_CACHE=3600

Docker¶

# Dockerfile
FROM node:18-alpine

# Variáveis de ambiente
ENV NODE_ENV=production
ENV PORT=8080

# Copiar arquivos
COPY . /app
WORKDIR /app

# Instalar dependências e compilar
RUN npm ci --only=production
RUN npm run build

# Usuário não-root
USER node

# Comando de início
CMD ["./grompt", "--port", "8080"]

Docker Compose¶

# docker-compose.yml
version: '3.8'

services:
  grompt:
    build: .
    ports:
      - "8080:8080"
    environment:
      - NODE_ENV=production
      - PORT=8080
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - CLAUDE_API_KEY=${CLAUDE_API_KEY}
    volumes:
      - ./logs:/app/logs
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/api/health"]
      interval: 30s
      timeout: 10s
      retries: 3

📋 Checklist de Configuração¶

✅ Configuração Básica¶

Baixar e instalar o binário do Grompt
Configurar pelo menos um provedor de IA
Testar conexão com grompt ask "teste" --dry-run
Configurar variáveis de ambiente
Testar interface web em http://localhost:8080

✅ Configuração Avançada¶

Configurar arquivo ~/.gromptrc
Configurar múltiplos provedores de IA
Configurar Ollama para uso local
Configurar logs e monitoramento
Configurar segurança (permissões de arquivo)

✅ Configuração de Produção¶

Configurar HTTPS e certificados
Configurar CORS para domínios específicos
Configurar rate limiting
Configurar backup de configurações
Configurar rotação de chaves de API

📚 Próximos Passos¶

Exemplos de Uso - Veja exemplos práticos e avançados
API Reference - Integre o Grompt programaticamente
Solução de Problemas - Resolva problemas comuns