Vector Vault
Build AI agents that think, remember, and act. Start free on your machine. Scale to production with zero infrastructure.
Start Free, Scale When Ready
Vector Vault gives you two ways to build:
🏠 Local Mode (Free) — Run entirely on your machine. No account needed. No limits. Perfect for learning, prototyping, and projects where your data stays local.
☁️ Cloud Platform — When you're ready for production, deploy to our Persistent Agentic Runtime (PAR). Sub-second responses, 99.9% uptime, visual workflow builder, and agents that can pause for days and resume instantly.
pip install vector-vault
Quick Start (Local Mode)
No signup. No API keys (except OpenAI for embeddings). Just code.
from vectorvault import Vault
# Create a local vault
vault = Vault(
vault='my_knowledge_base',
openai_key='YOUR_OPENAI_KEY',
local=True # Everything stays on your machine
)
# Add your data
vault.add("The mitochondria is the powerhouse of the cell")
vault.add("Neural networks are inspired by biological brains")
vault.add("Vector databases enable semantic search")
vault.get_vectors()
vault.save()
# Search by meaning, not keywords
results = vault.get_similar("How do AI systems learn?")
# → Returns: "Neural networks are inspired by biological brains"
# Or chat with your data
response = vault.get_chat(
"What powers the cell?",
get_context=True # Automatically retrieves relevant context
)
What You Can Build
RAG Applications
Give any LLM access to your knowledge base with automatic context retrieval.
response = vault.get_chat(
"How do I configure authentication?",
get_context=True,
n_context=5
)
Semantic Search
Find content by meaning. Search "budget issues" and find documents about "financial constraints."
results = vault.get_similar("budget issues", n=10)
AI Memory Systems
Give your agents persistent memory across conversations.
# Store conversation
vault.add(f"User asked about {topic}. Agent responded with {response}")
vault.get_vectors()
vault.save()
# Later, retrieve relevant context
context = vault.get_similar(new_user_message)
Document Q&A
Turn any document collection into a question-answering system.
# Load documents
for doc in documents:
vault.add(doc.text, meta={'source': doc.filename})
vault.get_vectors()
vault.save()
# Answer questions
answer = vault.get_chat("What's the refund policy?", get_context=True)
Going to Production
When you're ready to scale, Vector Vault Cloud provides:
Persistent Agentic Runtime (PAR)
Agents that pause for days, branch into parallel tasks, and resume instantly — without you managing servers.
Vector Flow
Design agent workflows visually with drag-and-drop. Branching logic, approvals, integrations, all in the browser.
Production Performance
- Sub-second streaming responses
- 99.9% uptime SLA
- Auto-scaling to thousands of concurrent conversations
Enterprise Ready
- SOC 2 compliant infrastructure
- Team collaboration
- Usage-based pricing
# Switch to cloud mode
vault = Vault(
user='you@company.com',
api_key='YOUR_VECTORVAULT_KEY',
openai_key='YOUR_OPENAI_KEY',
vault='production_kb'
)
# Same API, production infrastructure
response = vault.get_chat("Customer question here", get_context=True)
# Or run visual workflows
result = vault.run_flow('customer_support_agent', user_message="...")
Get started at vectorvault.io →
Core API
Initialization
# Local mode (free, no account)
vault = Vault(
vault='vault_name',
openai_key='sk-...',
local=True
)
# Cloud mode (production)
vault = Vault(
user='email',
api_key='vv_...',
openai_key='sk-...',
vault='vault_name'
)
Essential Methods
| Method | Description |
|---|---|
add(text, meta=None) |
Add text to the vault |
get_vectors() |
Generate embeddings |
save() |
Persist to storage |
get_similar(text, n=4) |
Semantic search |
get_chat(text, get_context=True) |
RAG chat |
get_items(ids) |
Retrieve by ID |
edit_item(id, text) |
Update item |
delete_items(ids) |
Remove items |
Convenience
# Add + embed + save in one call
vault.add_n_save("Your text here")
# Stream responses
for chunk in vault.get_chat_stream("Your question"):
print(chunk, end='')
How It Works
Vector Vault uses FAISS (Facebook AI Similarity Search) for fast, accurate vector operations:
- Add your text data
- Embed using OpenAI's embedding models
- Search by semantic similarity
- Chat with automatic context retrieval
Local mode stores everything in ~/.vectorvault/. Cloud mode syncs to our managed infrastructure.
Requirements
- Python 3.9+
- OpenAI API key (for embeddings)
Resources
- Website: vectorvault.io
- Vector Flow: app.vectorvault.io/vector-flow
- Full API Docs: Documentation
- Discord: Join the community
- JavaScript SDK: VectorVault-js
Contributing
git clone https://github.com/John-Rood/VectorVault.git
cd VectorVault
pip install -e .
# Run tests
cd VectorVault-Testing
python run_tests.py # Cloud tests
python test_local_mode.py # Local tests
License
MIT License
Start free. Scale infinitely. vectorvault.io
Model-compatible thinking levels
VectorVault ships a canonical model capability table and validates each selection before a provider call. Existing callers can omit the setting to preserve provider defaults.
from vectorvault import Vault, get_allowed_thinking_levels
print(get_allowed_thinking_levels("gpt-5.6"))
response = vault.get_chat(
"Compare these options carefully",
model="gpt-5.6",
thinking_level="high",
)
1 maintainer
Release files for vector-vault 7.4.9.25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vector_vault-7.4.9.25.tar.gz | 70.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vector_vault-7.4.9.25-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 137.2 kB
Release files / vector_vault-7.4.9.25.tar.gz
| Download URL | vector_vault-7.4.9.25.tar.gz |
|---|---|
| Size | 70.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5042598351ae3e3a1985cd68a5c64ae748c1983c9015d4211ac8efb6a70a79ca
|
|
BLAKE2b-256 checksum How to use checksums |
da7b227e5dafd3b45b0290101754f8cc7b7bb7e1abd716395b6305b1a42a4c8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Release files / vector_vault-7.4.9.25-py3-none-any.whl
| Download URL | vector_vault-7.4.9.25-py3-none-any.whl |
|---|---|
| Size | 66.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4f46e2467177c0fe86a2504747e2d4836fa6a333e40215461d7581fbdc936b46
|
|
BLAKE2b-256 checksum How to use checksums |
70c5fb3dcffaeac309179b2d3a23c930a9e2e423e6effd9dc62fab421a6eb8af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
