English Français العربية

io.github.brunosrz/vectora

Official registry Developer tools

AI assistant with RAG, web search, filesystem and memory. MCP sub-agent for Claude Code.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package vectora-agent
Claude Code 
claude mcp add vectora -e 'GOOGLE_API_KEY=<your google_api_key>' -e 'COHERE_API_KEY=<your cohere_api_key>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'OPENAI_API_KEY=<your openai_api_key>' -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'LANGSMITH_API_KEY=<your langsmith_api_key>' -- uvx vectora-agent==0.1.0rc3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vectora": {
            "command": "uvx",
            "args": [
                "vectora-agent==0.1.0rc3"
            ],
            "env": {
                "GOOGLE_API_KEY": "<your google_api_key>",
                "COHERE_API_KEY": "<your cohere_api_key>",
                "TAVILY_API_KEY": "<your tavily_api_key>",
                "OPENAI_API_KEY": "<your openai_api_key>",
                "ANTHROPIC_API_KEY": "<your anthropic_api_key>",
                "LANGSMITH_API_KEY": "<your langsmith_api_key>"
            }
        }
    }
}

Environment variables

  • GOOGLE_API_KEY secret Google Gemini API key (recommended free-tier LLM provider)
  • COHERE_API_KEY required secret Cohere API key — required for RAG embeddings and reranking
  • TAVILY_API_KEY required secret Tavily API key — required for web search and URL extraction
  • OPENAI_API_KEY secret OpenAI API key (optional — alternative LLM provider)
  • ANTHROPIC_API_KEY secret Anthropic API key (optional — alternative LLM provider)
  • LANGSMITH_API_KEY secret LangSmith API key (optional — tracing and observability)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Vectora — Monorepo
  2. Estrutura
  3. CI/CD (.github/workflows/)
  4. Desenvolvimento
  5. Licença

Vectora — Monorepo

Monorepo da Vectora. Cada produto vive em sua própria pasta, com toolchain e lockfile independentes. O que conecta tudo é o GitHub Actions (um workflow por projeto, gated por path) e o pre-commit compartilhado na raiz.

Estrutura

PastaProjetoStackDeploy
vectora/App Vectora (assistente de IA self-hosted)Python (uv) + Vite + ElectronInstaladores nativos (Nuitka + Electron) via canal de update
company/Site institucionalTanStack Start + Vite (pnpm)Vercel → vectora.company
docs/DocumentaçãoHugoVercel → docs.vectora.company
services/Gateway (OAuth/webhooks pro desktop, ex-relay) + updates (distribuição de releases) — era relay/ + update-server/, unificadosHono + Cloudflare Workers (pnpm)Cloudflare (wrangler)

O app em si (backend Python, frontend Vite, casca Electron) fica todo dentro de vectora/ — veja vectora/README.md para detalhes de arquitetura, build e CLI.

CI/CD (.github/workflows/)

4 workflows reais, cada um gated por path (on.push/pull_request.paths): uma mudança só no vectora/ não dispara o build/deploy de company/docs/services.

WorkflowDispara emFaz
vectora.ymlvectora/**, tags v*lint • security • build • testes (unit/integration/e2e) • release nativo (Nuitka + Electron) • publica no canal de update (R2 + KV)
edge.ymlcompany/**, services/**, docs/**lint/typecheck/test dos 3 projetos • deploy automático em push em master (Vercel + Cloudflare)
release-please.ymlpush em mastermantém o PR de release acumulado (Conventional Commits) — mesclar publica a tag vX.Y.Z
pr-checks.ymlpull requestslabels automáticos • valida título em Conventional Commits

Não existe workflow de Docker Build/Push, CodeQL nem triage de issues — a distribuição do app vectora é via instaladores nativos (não imagem Docker).

Secrets esperados
SecretUsado por
GOOGLE_API_KEY, COHERE_API_KEY, TAVILY_API_KEY, LLM_PROVIDER, LOG_LEVELtestes do vectora
WIN_CERTIFICATE_BASE64, WIN_CERTIFICATE_PASSWORD, APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD, APPLE_TEAM_ID, VECTORA_RELEASES_TOKENassinatura/publicação dos instaladores nativos
VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID_COMPANY, VERCEL_PROJECT_ID_DOCSdeploy Vercel (company + docs)
CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEYdeploy do services + canal de update (R2)

Desenvolvimento

Cada projeto é independente — entre na pasta e use o gerenciador dele:

# App Vectora (Python + Vite + Electron)
cd vectora && uv sync && uv run vectora start

# Site institucional
cd company && pnpm install && pnpm dev

# Docs (Hugo)
cd docs && hugo server

# Services (gateway + updates)
cd services && pnpm install && pnpm dev
Pre-commit (raiz)

O .pre-commit-config.yaml na raiz cobre todos os projetos (ruff/ty/bandit no vectora/, prettier/oxlint/tsc no frontend, actionlint nos workflows):

pre-commit install
pre-commit run --all-files

Licença

Proprietária. Consulte LICENSE.

Frequently asked questions

What is io.github.brunosrz/vectora?

AI assistant with RAG, web search, filesystem and memory. MCP sub-agent for Claude Code.

How do I install io.github.brunosrz/vectora?

It runs on your machine. In Claude Code: claude mcp add vectora -e 'GOOGLE_API_KEY=<your google_api_key>' -e 'COHERE_API_KEY=<your cohere_api_key>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'OPENAI_API_KEY=<your openai_api_key>' -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'LANGSMITH_API_KEY=<your langsmith_api_key>' -- uvx vectora-agent==0.1.0rc3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.brunosrz/vectora need an API key?

Yes. It expects GOOGLE_API_KEY, COHERE_API_KEY, TAVILY_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, LANGSMITH_API_KEY, which you set in its configuration.

Is io.github.brunosrz/vectora open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.brunosrz/vectora?

It is published by brunosrz. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.