How shankarbkori/vectordb works
VectorDB is an in-memory vector search service with two user-facing paths: direct vector operations and document-based retrieval-augmented generation (RAG). Document ingestion chunks text, obtains embeddings from local Ollama, and stores chunks for retrieval; question answering embeds a query, retrieves relevant chunks, and uses Ollama generation. Direct vector requests use a unified database that maintains multiple search indexes. The README also documents HNSW, KD-tree, brute-force search, distance metrics, and benchmark capabilities. Relationships for unsampled source are included only where the README or source index supports them.
Main entry points: VectorDB.java Vector Store · DocumentDB.java Document Store · DocumentController.java Document API · DistanceFunctions.java Distance Metrics
Components 17
REST API
- Vector API
vectordb/src/main/java/com/vectordb/api/DemoVectorController.java - Document API
vectordb/src/main/java/com/vectordb/api/DocumentController.java - Application Startup
vectordb/src/main/java/com/vectordb/VectorDbApplication.java
Document RAG
- Text Chunker
vectordb/src/main/java/com/vectordb/util/TextChunker.java - Ollama Client
vectordb/src/main/java/com/vectordb/ollama/OllamaClient.java
Vector Storage
- Document Store
vectordb/src/main/java/com/vectordb/db/DocumentDB.java - Vector Store
vectordb/src/main/java/com/vectordb/db/VectorDB.java - Demo Loader
vectordb/src/main/java/com/vectordb/util/DemoLoader.java
Search Engines
- HNSW Index
vectordb/src/main/java/com/vectordb/search/HNSW.java - KD-Tree Index
vectordb/src/main/java/com/vectordb/search/KDTree.java - Brute-Force Index
vectordb/src/main/java/com/vectordb/search/BruteForce.java
Shared Core
- Distance Metrics
vectordb/src/main/java/com/vectordb/distance/DistanceFunctions.java - Vector Record
vectordb/src/main/java/com/vectordb/model/VectorItem.java - Document Chunk
vectordb/src/main/java/com/vectordb/model/DocItem.java - Search Result
vectordb/src/main/java/com/vectordb/search/SearchResult.java
Other components
- API Client
- Ollama Service
Connections 29
- API Client → Vector API: calls endpoints
README.md - API Client → Document API: calls endpoints
README.md - Document API → Text Chunker: chunks text
vectordb/src/main/java/com/vectordb/api/DocumentController.java - Document API → Ollama Client: requests embeddings
vectordb/src/main/java/com/vectordb/api/DocumentController.java - Document API → Ollama Client: requests generation
vectordb/src/main/java/com/vectordb/api/DocumentController.java - Document API → Document Store: stores and searches
vectordb/src/main/java/com/vectordb/api/DocumentController.java - Document API → Vector Store: reads demo status
vectordb/src/main/java/com/vectordb/api/DocumentController.java - Ollama Client → Ollama Service: sends HTTP requests
vectordb/src/main/java/com/vectordb/ollama/OllamaClient.java - Vector API → Vector Store: inserts and searches
vectordb/src/main/java/com/vectordb/api/DemoVectorController.java - Application Startup → Demo Loader: loads demo data
vectordb/src/main/java/com/vectordb/VectorDbApplication.java - Demo Loader → Vector Store: populates vectors
vectordb/src/main/java/com/vectordb/util/DemoLoader.java - Document Store → HNSW Index: indexes chunks
vectordb/src/main/java/com/vectordb/db/DocumentDB.java - Document Store → Brute-Force Index: indexes chunks
vectordb/src/main/java/com/vectordb/db/DocumentDB.java - Document Store → Distance Metrics: scores queries
vectordb/src/main/java/com/vectordb/db/DocumentDB.java - Document Store → Document Chunk: stores chunks
vectordb/src/main/java/com/vectordb/db/DocumentDB.java - Document Store → Vector Record: creates index records
vectordb/src/main/java/com/vectordb/db/DocumentDB.java - Document Store → Search Result: maps search hits
vectordb/src/main/java/com/vectordb/db/DocumentDB.java - Vector Store → Brute-Force Index: maintains and queries
vectordb/src/main/java/com/vectordb/db/VectorDB.java - Vector Store → KD-Tree Index: maintains and queries
vectordb/src/main/java/com/vectordb/db/VectorDB.java - Vector Store → HNSW Index: maintains and queries
vectordb/src/main/java/com/vectordb/db/VectorDB.java - Vector Store → Distance Metrics: selects metric
vectordb/src/main/java/com/vectordb/db/VectorDB.java - Vector Store → Vector Record: stores records
vectordb/src/main/java/com/vectordb/db/VectorDB.java - Vector Store → Search Result: maps index hits
vectordb/src/main/java/com/vectordb/db/VectorDB.java - Brute-Force Index → Distance Metrics: computes distances
vectordb/src/main/java/com/vectordb/search/BruteForce.java - Brute-Force Index → Search Result: returns ranked hits
vectordb/src/main/java/com/vectordb/search/BruteForce.java - HNSW Index → Distance Metrics: computes distances
vectordb/src/main/java/com/vectordb/search/HNSW.java - HNSW Index → Search Result: returns ranked hits
vectordb/src/main/java/com/vectordb/search/HNSW.java - KD-Tree Index → Distance Metrics: computes distances
vectordb/src/main/java/com/vectordb/search/KDTree.java - KD-Tree Index → Search Result: returns ranked hits
vectordb/src/main/java/com/vectordb/search/KDTree.java