Solução de Problemas

# Instale Node.js: https://nodejs.org (LTS recomendado)
node --version # Deve retornar v18+
npm --version # Deve retornar 9+

# Configure npm para local installation
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

# Adicione a linha acima ao ~/.bashrc ou ~/.zshrc
npm install -g @kaffyn/vectora

# Verifique instalação
npm list -g @kaffyn/vectora

# Reinstale
npm install -g @kaffyn/vectora

# Teste
vectora --version

# Verifique se as chaves estão definidas
echo $GEMINI_API_KEY
echo $VOYAGE_API_KEY

# Se vazias, configure
export GEMINI_API_KEY="sua_chave_aqui"
export VOYAGE_API_KEY="sua_chave_aqui"

# Ou crie .env file
cat > .env << 'EOF'
GEMINI_API_KEY=sk-xxx
VOYAGE_API_KEY=pa-xxx
EOF

# Valide YAML
yamllint vectora.config.yaml

# Ou use online: https://yamllint.com

# Erros comuns:
# - Indentação inconsistente (use 2 espaços)
# - Valores entre aspas faltando
# - Símbolos especiais não escapados

# Atualize vectora.config.yaml
namespace:
  trust_folder: "." # ou caminho válido

{
  "mcpServers": {
    "vectora": {
      "command": "vectora",
      "args": ["mcp-serve"]
    }
  }
}

# Verifique chaves de API
echo $GEMINI_API_KEY
echo $VOYAGE_API_KEY

# Teste conectividade
curl https://generativelanguage.googleapis.com/v1beta/models

# Se falhar, sua chave pode estar inválida
# Gere nova chave em https://aistudio.google.com/app/apikey

Use Vectora para buscar contexto sobre autenticação.
Procure no codebase por implementações de JWT.

# Aguarde o reset do quota (próximo minuto)
# Ou faça upgrade para plano Plus em https://vectora.dev/plans

# Para debug: verifique uso
vectora stats --provider gemini

# Gere nova chave em https://dash.voyageai.com/api-keys
vectora config set --key VOYAGE_API_KEY --value "nova_chave"

# Teste
vectora test --provider voyage

# Aumenta timeout (padrão: 30s)
export VECTORA_TIMEOUT_MS=60000

# Teste conectividade
ping generativelanguage.googleapis.com

# Se VPN/proxy:
export HTTP_PROXY=http://proxy:port
export HTTPS_PROXY=https://proxy:port

# Inicialize projeto
vectora init --name "Meu Projeto"

# Ou especifique em claude_desktop_config.json
"VECTORA_NAMESPACE": "my-project"

# Force reindexing
vectora ingest --project . --force

# Verifique status
vectora status --project .

# Tente query diferente ou mais específica
# Exemplo: em vez de "auth", tente "JWT validation in middleware"

# Use batch processing
vectora ingest --batch-size 16 # default: 32

# Ou configure em vectora.config.yaml
indexing:
  batch_size: 16

# Para desenvolvimento local, use fallback
providers:
  embedding:
    fallback: "local" # local embedding via ollama

# Limite indexação automática
vectora config set VECTORA_AUTO_INGEST=false

# Ou agende indexação em horário off-peak
vectora schedule ingest --time 02:00 --recurring daily

# Limpe cache
vectora cache clear

# Reduza cache size
vectora config set VECTORA_CACHE_SIZE=100MB

# Verifique consumo
vectora stats --memory

# Via CLI
vectora --log-level debug

# Via variável
export VECTORA_LOG_LEVEL=debug

# Salve logs em arquivo
vectora mcp-serve --log-file debug.log

# Status geral
vectora status

# Detalhes da configuração
vectora config list

# Estatísticas de uso
vectora stats

# Verificar indexação
vectora index --list --verbose