Product
Supavector gives AI apps a governed memory layer.
Put retrieval, memory retention, access control, and feedback loops behind one backend surface instead of spreading them across your app.
Supavector is open source. The source code, installer scripts, and self-hosted setup files are available in the GitHub repository.
Hosted API
Get a token, add credit, start calling.
No servers to run. Sign up, create a project in the Dashboard, add credit, and you're calling the API in minutes.
Prefer zero cost and full control? Supavector is fully open source — run it yourself, free forever ↓
Sign up & create a project
Sign in with Google, GitHub, or email. Click Dashboard → New Project. Copy the token shown — it's only displayed once.
Add credit for AI generation
Dashboard → + Add Credit. Choose an amount, pay via Stripe. Indexing and search are free — only /ask and /boolean_ask deduct credit.
Wire up your environment
Set two env vars in your app, agent, or script. That's the entire setup — no Docker, no Postgres, no config files.
SUPAVECTOR_BASE_URL=https://your-host SUPAVECTOR_API_KEY=supav_your_token
curl -X POST "${SUPAVECTOR_BASE_URL}/v1/docs" \
-H "Authorization: Bearer ${SUPAVECTOR_API_KEY}" \
-H "Idempotency-Key: doc-001" \
-H "Content-Type: application/json" \
-d '{
"docId": "welcome",
"collection": "default",
"text": "Supavector stores memory for agents."
}'
curl -X POST "${SUPAVECTOR_BASE_URL}/v1/ask" \
-H "Authorization: Bearer ${SUPAVECTOR_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"question": "What does Supavector store?",
"k": 5,
"policy": "amvl"
}'
import os, requests
BASE = os.environ["SUPAVECTOR_BASE_URL"]
KEY = os.environ["SUPAVECTOR_API_KEY"]
HDR = {
"Authorization": f"Bearer {KEY}",
"Content-Type": "application/json",
}
requests.post(
f"{BASE}/v1/docs",
headers={**HDR, "Idempotency-Key": "doc-001"},
json={
"docId": "welcome",
"collection": "default",
"text": "Supavector stores memory for agents.",
},
).raise_for_status()
r = requests.post(
f"{BASE}/v1/ask",
headers=HDR,
json={
"question": "What does Supavector store?",
"k": 5,
"policy": "amvl",
},
)
r.raise_for_status()
print(r.json()["data"]["answer"])
const BASE = process.env.SUPAVECTOR_BASE_URL;
const KEY = process.env.SUPAVECTOR_API_KEY;
async function ar(path, body, extra = {}) {
const res = await fetch(`${BASE}${path}`, {
method: "POST",
headers: {
"Authorization": `Bearer ${KEY}`,
"Content-Type": "application/json",
...extra,
},
body: JSON.stringify(body),
});
if (!res.ok) throw new Error(await res.text());
return res.json();
}
await ar("/v1/docs",
{ docId: "welcome", collection: "default",
text: "Supavector stores memory for agents." },
{ "Idempotency-Key": "doc-001" }
);
const { data } = await ar("/v1/ask", {
question: "What does Supavector store?",
k: 5,
policy: "amvl",
});
console.log(data.answer);
const BASE = "https://your-host";
const KEY = "supav_your_token"; // keep server-side in prod
await fetch(`${BASE}/v1/docs`, {
method: "POST",
headers: {
"Authorization": `Bearer ${KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "doc-001",
},
body: JSON.stringify({
docId: "welcome",
collection: "default",
text: "Supavector stores memory for agents.",
}),
});
const res = await fetch(`${BASE}/v1/ask`, {
method: "POST",
headers: {
"Authorization": `Bearer ${KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
question: "What does Supavector store?",
k: 5,
policy: "amvl",
}),
});
const { data } = await res.json();
console.log(data.answer);
CREDIT_REQUIRED — balance is zero. Add credit from the Dashboard.
CREDIT_CHECK_FAILED — transient error. Retry with backoff.
supav_ prefix) bypass the credit system entirely.
Self-Host And Build On Top
Up and running in minutes.
Install the CLI, start the stack, and write your first memory in under five minutes. Full control — your infra, your data.
Clone and install the CLI
Clone the repo, then run the installer. Works on macOS, Linux, and Windows.
git clone https://github.com/Emmanuel-Bamidele/supavector.git cd supavector && ./scripts/install.sh
Start the stack
One command brings up the vector core, gateway, and Postgres locally.
supavector start
Write your first memory
Use the CLI or call the API directly with your service token.
supavector write --text "Hello, memory"
Ask a question
Query the memory you just wrote. Supavector retrieves and answers grounded in your data.
supavector ask --question "What did I store?"
Add to your app env
Export the base URL and service token so your backend can reach Supavector.
export SUPAVECTOR_BASE_URL="http://localhost:3000" export SUPAVECTOR_API_KEY="YOUR_SERVICE_TOKEN"
Call server-to-server
Your backend calls Supavector directly. No browser, no end-user login needed.
curl -X POST "$SUPAVECTOR_BASE_URL/v1/ask" \
-H "X-API-Key: $SUPAVECTOR_API_KEY" \
-d '{"question":"What did I store?","k":3}'
What shifts
Move memory out of app glue and into infrastructure.
Teams stop stitching together retrieval logic, ACL rules, expiry behavior, and quality loops in five different places. Supavector centralizes the memory layer so product code can stay focused on the actual experience.
- Keep your frontend, backend, and agent orchestration where they already belong.
- Use one governed path for writes, search, ask, and memory recall.
- Push setup, auth, API, and policy details into Documentation instead of bloating this tab.
Customer assistants, internal copilots, research agents, and controlled automation where memory quality matters after day one.
Tenant scoping, service-token auth, retrieval policies, and lifecycle controls are already part of the platform surface.
Open Source
Built in the open. MIT licensed.
Supavector is fully open source. Every line — the C++ vector core, Node.js gateway, installer scripts, and Docker Compose files — is available to inspect, fork, and self-host. There is no hosted service, no vendor lock-in, and no black-box dependencies.
Fork it, deploy it, or contribute. The whole platform is yours to run.
How it fits
Keep your app. Add Supavector behind it.
Supavector becomes the memory layer behind your existing product instead of replacing your product with a new one.
Connect sources
Index docs and URLs, or write memory directly from your app, workers, and automations.
Retrieve with policy
Search, ask, and recall through one platform while choosing TTL, LRU, or AMVL for the workload.
Govern and improve
Apply tenant controls, enforce access rules, and keep memory quality moving in the right direction over time.
Explore further
See setup, API details, and the open source code.
Documentation covers setup, auth, service tokens, API endpoints, memory policies, and integration examples. If you want to inspect or fork Supavector itself, the source code is in the GitHub repository.