The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Vectora listing page.
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.
| Pasta | Projeto | Stack | Deploy |
|---|---|---|---|
vectora/ | App Vectora (assistente de IA self-hosted) | Python (uv) + Vite + Electron | Instaladores nativos (Nuitka + Electron) via canal de update |
company/ | Site institucional | TanStack Start + Vite (pnpm) | Vercel → vectora.company |
docs/ | Documentação | Hugo | Vercel → docs.vectora.company |
services/ | Gateway (OAuth/webhooks pro desktop, ex-relay) + updates (distribuição de releases) — era relay/ + update-server/, unificados | Hono + 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.
.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.
| Workflow | Dispara em | Faz |
|---|---|---|
vectora.yml | vectora/**, tags v* | lint • security • build • testes (unit/integration/e2e) • release nativo (Nuitka + Electron) • publica no canal de update (R2 + KV) |
edge.yml | company/**, services/**, docs/** | lint/typecheck/test dos 3 projetos • deploy automático em push em master (Vercel + Cloudflare) |
release-please.yml | push em master | mantém o PR de release acumulado (Conventional Commits) — mesclar publica a tag vX.Y.Z |
pr-checks.yml | pull requests | labels 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).
| Secret | Usado por |
|---|---|
GOOGLE_API_KEY, COHERE_API_KEY, TAVILY_API_KEY, LLM_PROVIDER, LOG_LEVEL | testes do vectora |
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, VERCEL_PROJECT_ID_COMPANY, VERCEL_PROJECT_ID_DOCS | deploy Vercel (company + docs) |
CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY | deploy do services + canal de update (R2) |
Cada projeto é independente — entre na pasta e use o gerenciador dele:
O .pre-commit-config.yaml na raiz cobre todos os projetos (ruff/ty/bandit no
vectora/, prettier/oxlint/tsc no frontend, actionlint nos workflows):
Proprietária. Consulte LICENSE.