Vectora

FreeNot checked

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

by io.github.brunosrz

GitHub Embed

About

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

README

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

Pasta	Projeto	Stack	Deploy
vectora/	App Vectora (assistente de IA self-hosted)	Python (uv) + Vite + Electron	Docker (GHCR) + instaladores nativos
company/	Site institucional	TanStack Start + Vite (pnpm)	Vercel → vectora.company
docs/	Documentação	Docusaurus (pnpm)	Vercel → docs.vectora.company
services/	Relay (OAuth/webhooks pro desktop) + updates (distribuição de releases) — era `relay/` + `update-server/`, unificados	Hono + Cloudflare Workers (pnpm)	Cloudflare (wrangler)
`documents/`	Notas de design/planejamento (markdown interno)	—	não publicado

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/`)

Um workflow por projeto, gated por path (on.push/pull_request.paths): uma mudança só no vectora/ não dispara o build/deploy de company, docs etc.

Workflow	Dispara em	Faz
`vectora.yml`	`vectora/*`, tags `v`	lint • security • build • testes (unit/stress/integration/e2e) • Docker push (GHCR) • release nativo (Nuitka + Electron)
`company.yml`	`company/**`	lint/typecheck/test/build • deploy Vercel (master)
`docs.yml`	`docs/**`	typecheck/build • deploy Vercel (master)
`services.yml`	`services/**`	install/typecheck/test • deploy Cloudflare (master)
`codeql.yml`	master + agenda	análise CodeQL (Python + Actions)
`triage.yml`	issues	label `needs-triage` + boas-vindas

Secrets esperados

Secret	Usado por
`GOOGLE_API_KEY`, `COHERE_API_KEY`, `TAVILY_API_KEY`	testes do vectora
`GHCR_TOKEN`	push da imagem Docker (fallback: `GITHUB_TOKEN`)
`WIN_CERTIFICATE_BASE64`, `WIN_CERTIFICATE_PASSWORD`, `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`, `APPLE_TEAM_ID`, `VECTORA_RELEASES_TOKEN`	assinatura/publicação dos instaladores nativos
`VERCEL_TOKEN`, `VERCEL_ORG_ID`	deploy Vercel (company + docs)
`VERCEL_PROJECT_ID_COMPANY`, `VERCEL_PROJECT_ID_DOCS`	projeto Vercel de cada site
`CLOUDFLARE_API_TOKEN`, `CLOUDFLARE_ACCOUNT_ID`	deploy do services

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
cd docs && pnpm install && pnpm dev

# Services (relay + 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.

from github.com/brunosrz/vectora

Install Vectora in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install vectora

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add vectora -- uvx vectora-agent

FAQ

Is Vectora MCP free?

Yes, Vectora MCP is free — one-click install via Unyly at no cost.

Does Vectora need an API key?

No, Vectora runs without API keys or environment variables.

Is Vectora hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Vectora in Claude Desktop, Claude Code or Cursor?

Open Vectora on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

by mcpdotdirect

Compare Vectora with

VectoravsGitHub VectoravsFilesystem VectoravsMemory VectoravsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs