Summary
This is a sub-agent designed to run within Claude Code that extends your AI assistant with retrieval-augmented generation, web search capabilities, filesystem access, and persistent memory. You'd reach for this when you need Claude to pull in external knowledge during coding sessions, search the web for current information, interact with your local files, or maintain context across conversations. It's essentially a power-up for Claude Code that adds the kind of grounded, stateful capabilities you'd otherwise need to implement yourself or juggle through multiple tools.
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →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.
Featured
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Configuration
GOOGLE_API_KEYsecretGoogle Gemini API key (recommended free-tier LLM provider)
COHERE_API_KEY*secretCohere API key — required for RAG embeddings and reranking
TAVILY_API_KEY*secretTavily API key — required for web search and URL extraction
OPENAI_API_KEYsecretOpenAI API key (optional — alternative LLM provider)
ANTHROPIC_API_KEYsecretAnthropic API key (optional — alternative LLM provider)
LANGSMITH_API_KEYsecretLangSmith API key (optional — tracing and observability)
Registryactive
Packagevectora-agent
TransportSTDIO
AuthRequired
UpdatedMay 22, 2026
