ctxvault 0.1.0

ctxvault is a local-first knowledge vault that indexes your documents, generates embeddings, and enables fast semantic search via CLI or API. Designed for personal knowledge bases, RAG pipelines, and AI agents.

CtxVault

Local semantic search vault for LLMs.

CtxVault lets you index documents locally, generate embeddings, and query them with semantic search.
Designed as a lightweight RAG backend for agents, scripts, and LLM workflows.

Why CtxVault

• 100% local (no cloud, no data sharing)
• simple CLI
• works offline
• persistent vector store (Chroma)
• file-based workflow
• agent/API ready (future)

Ideal for:

• personal knowledge bases
• private documents
• local RAG pipelines
• AI agents needing contextual memory

---

Install

Python 3.10+

pip install -e .

---

Quickstart

Initialize a vault:

ctxvault init ./my-vault

Index files or folders:

ctxvault index ./my-vault/docs

Query:

ctxvault query "what is project Orion?"

---

CLI Commands

init

Initialize a vault directory.

ctxvault init <path>

---

index

Index a file or directory.

ctxvault index <path>

---

query

Semantic search inside the vault.

ctxvault query "<text>"

---

delete

Remove a document from the vault.

ctxvault delete <path>

---

reindex

Reindex a document after changes.

ctxvault reindex <path>

---

list

List indexed documents.

ctxvault list

---

Privacy

All processing happens locally. No data is sent to external services.

---

Roadmap

• CLI MVP
• FastAPI server
• sync and file watcher
• multi-vault support

---

License

MIT