v1.0.0 — Production Ready

Forge your vector
database. Own it forever.

A universal, local-first Python vector database with AES-256 encryption, hybrid search, and zero cloud dependency. Your data never leaves your machine.

Get Started → ☆ Star on GitHub
$ pip install vecforge 📋
test_scores_varied.py
# Multi-domain hybrid search & precise scoring from vecforge import VecForge db = VecForge(":memory:") db.add("The quick brown fox jumps over the lazy dog") db.add("NASA's Artemis aims to return humans to the Moon") db.add("Authentic Italian pizza requires a wood-fired oven") results = db.search("space exploration") for r in results: print(f"{r.score:.3f} → {r.text}")
Terminal Output
1.000 → NASA's Artemis aims to return humans to the Moon 0.134 → Authentic Italian pizza requires a wood-fired oven 0.000 → The quick brown fox jumps over the lazy dog

Perfect [0, 1] Min-Max Normalization across any domain

Everything you need. Nothing you don't.

Enterprise-grade capabilities without cloud lock-in, hidden fees, or egress charges.

🔐

AES-256 Encryption

SQLCipher-powered encryption at rest. Your data is unreadable without the key. Always use environment variables — never hardcode.

🔍

Hybrid Search

4-stage cascade pipeline: FAISS dense retrieval → BM25 keyword merge → metadata filtering → cross-encoder reranking.

🛡️

Namespace Isolation

Hard multi-tenant boundaries at the SQL layer. Every query is scoped — tenants never see each other's data.

🔑

Role-Based Access

Admin, read-write, read-only roles with API key mapping. No key = local admin for zero-friction development.

📄

Auto-Ingestion

Drop in PDFs, DOCX, HTML, TXT, Markdown. Smart chunking with configurable overlap. Recursive directory support.

📋

Audit Logging

Append-only JSONL logs for compliance. Track every add, search, and delete with actor, timestamp, and metadata.

VecForge vs. the rest

See how VecForge stacks up against popular vector databases.

Feature Pinecone ChromaDB ⚡ VecForge
Local-first ❌ Cloud-only ✅ Always
Encryption at rest ✅ AES-256
Hybrid search ✅ Dense + BM25
Namespace isolation ✅ Cloud ✅ Local
RBAC ✅ Cloud ✅ Built-in
Audit logging ✅ JSONL
Price $$$$ Free ✅ Free

Ready-to-run demos

Real-world use cases to get you started immediately.

🏥

Hospital Search

Medical record retrieval with namespace isolation per ward and metadata filtering.

⚖️

Legal Documents

NDA and contract search with type/year filtering and clause discovery.

🌍

GIS Data Search

Geospatial dataset discovery with USGS, Sentinel, and OpenStreetMap data.

🤖

RAG Pipeline

Retrieval-Augmented Generation with VecForge as the retrieval backend.

🏢

Multi-Tenant SaaS

Namespace isolation, RBAC, and audit logging for SaaS applications.

💻

Codebase Assistant

Code documentation semantic search with module and method indexing.

Learn VecForge

Comprehensive guides from quickstart to advanced configuration.

Quickstart 📦 Installation 🧠 Core Concepts 🔍 Search Guide 🔐 Security Guide 📄 Ingestion Guide 📖 API Reference 🖥️ CLI Reference 🌐 REST API ⚙️ Configuration

Ready to forge your vault?

Install VecForge and start searching in under 60 seconds. No cloud account, no API key, no credit card.