OSS

The OSS bundle at github.com/caura-ai/caura ships everything you need: API, worker, plugin, and a Postgres + pgvector schema. Apache 2.0.

PrerequisitesCopy Anchor Link

• Docker 24+ and Docker Compose v2
• 4 GB RAM, 2 vCPU minimum
• An entity-extraction provider key for enrichment — one of: OpenAI, Gemini, or OpenRouter (per .env.example provider matrix). Configure embeddings separately; for example, use EMBEDDING_PROVIDER=openai with OPENAI_API_KEY when choosing Gemini or OpenRouter for enrichment. Vertex AI is platform-tier only (managed deployment).

Anthropic is not supported for Caura enrichment, entity extraction, or contradiction detection. These operations require structured JSON output that the Anthropic compatibility endpoint used by Caura rejects. Do not set ENTITY_EXTRACTION_PROVIDER=anthropic; current OSS rejects that configuration at startup.

Bring it upCopy Anchor Link

git clone https://github.com/caura-ai/caura
cd caura
cp .env.example .env       # set IS_STANDALONE=true, EMBEDDING_PROVIDER=, ENTITY_EXTRACTION_PROVIDER=, OPENAI_API_KEY=…
docker compose up -d

The API listens on :8000, the worker runs in the background, and migrations apply on first boot. You can now follow the Quickstart and pick MCP or REST.

Auth modesCopy Anchor Link

Pick one — they are mutually exclusive:

• IS_STANDALONE=true — no auth, single tenant. Fine for laptops, fine for trusted networks.
• ADMIN_API_KEY=... — full access with one key. Multi-tenant.
• CAURA_API_KEY=... + X-Tenant-ID header — shared gate, one key per tenant.

Going furtherCopy Anchor Link

• Architecture overview
• Environment variables reference
• Contribute on GitHub