⚡ Spector — The AI Memory Backbone¶
Zero-overhead, agent-ready AI search and cognitive memory — embedded in a single JVM.
Spector is a Java-native AI search engine and cognitive memory system that combines SIMD-accelerated vector search, keyword search (BM25), and biologically-inspired memory consolidation into a single embeddable library. No Docker, no external databases, no Python — just a JAR.
Connect AI agents via the built-in MCP server (Claude Desktop, Cursor, custom agents), embed directly in your Spring Boot app, or run standalone. Spector delivers sub-millisecond search at scale with zero garbage collection pressure thanks to Project Panama off-heap memory.
🔥 Key Numbers¶
| Metric | Value |
|---|---|
| 🧠 Cognitive Recall | 0.13ms p50 at 1M memories |
| ⚡ Vector Search | 88µs p50 (10K docs, 128-dim) |
| 🚀 Peak QPS | 61,011 concurrent searches |
| 🤖 MCP Tools | 13 tools (6 search + 7 cognitive memory) |
| 🗜️ Compression | 4×–32× (SVASQ-8 to IVF-PQ) |
| ✅ Test Suite | 685+ tests, all passing |
| 📦 Dependencies | Zero (JDK only) |
🗺️ Choose Your Path¶
| Page | What you'll learn |
|---|---|
| Quick Start | Build, run, and search in 5 minutes |
| MCP Server Guide | Connect Claude Desktop, Cursor, or custom agents |
| Installation | Prerequisites and setup options |
| Configuration | All parameters with tuning advice |
| REST API Reference | All endpoints with curl examples |
| Cognitive Memory | Getting started with AI agent memory |
| Cortex Dashboard | Real-time neural visualization dashboard |
| Page | What you'll learn |
|---|---|
| Architecture Overview | Module diagram, data flow, threading model |
| Core Concepts | HNSW, IVF-PQ, BM25, RRF, SIMD deep-dives |
| Memory Architecture | How cognitive memory works under the hood |
| 6-Phase Scoring Pipeline | Fused SIMD scoring across memory tiers |
| Cortex Dashboard | Watch your AI's brain think — 12+ live panels |
| SVASQ Quantization | Our proprietary SIMD-first quantization engine |
| Benchmarks | Empirical sweeps on 4096-dim embeddings |
| Page | What you'll learn |
|---|---|
| Contributing Guide | Development setup and PR process |
| JDK API Status | Vector API, Panama FFM compatibility |
| Roadmap | What's planned next |
| FAQ | Common questions answered |
💡 How It Works¶
Spector combines three search modalities — semantic vectors, keyword matching, and cognitive scoring — into a single fused pipeline:
graph LR
A["🤖 AI Agent"] --> B["📡 MCP Server"]
B --> C["⚡ SpectorEngine"]
C --> D["🧠 Hybrid Search"]
D --> E["🎯 RRF Fusion"]
E --> F["🤖 LLM Re-ranking"]
F --> G["✨ Results"]
H["📄 Document"] --> I["🧩 Chunking"]
I --> J["🧬 Embedding"]
J --> C What Makes Spector Different¶
- Embedded deployment — runs as a library inside your JVM. No Docker, no servers, no network hops.
- Agent-native — 13 MCP tools for search, memory, and cognitive operations. Connect Claude Desktop or Cursor in one config line.
- Cognitive memory — the only system combining power-law decay, Two-Factor strengthening (Bjork & Bjork), emotional valence, and Hebbian association in a single scoring formula.
- Zero GC pressure — all vector data and headers live off-heap via Project Panama. The JVM garbage collector never sees memory records.
- SIMD everywhere — vector distance, quantization, and scoring use Java Vector API (AVX2/AVX-512/NEON) for hardware-accelerated computation.
New here?
Start with Quick Start to build and run your first search in under 5 minutes. Want to connect an AI agent? See the MCP Server Guide.
🌟 Project Stats¶
| Language | Java 25 |
| License | Apache 2.0 · BSL 1.1 (memory module) |
| Modules | 25 Maven modules |
| Dependencies | Zero (JDK only) |
| SIMD | AVX2 / AVX-512 / NEON |
| GPU | CUDA via Panama FFM |
| MCP | Built-in, 13 agent-ready tools |
| Distributed | gRPC fan-out + consistent hashing |
Built with ⚡ by Spectrayan · GitHub · Apache 2.0 · BSL 1.1 (memory)