Home

⚡ Welcome to Spector

The Zero-Overhead, Agent-Ready AI Memory Backbone.

Welcome to the Spector documentation — your central hub for the high-performance, agent-native AI search engine. Whether you're connecting AI agents via MCP, building RAG pipelines, powering recommendation systems, or need sub-millisecond search with zero infrastructure, you're in the right place.

---

🔥 Why Spector?

Metric	Value
🤖 MCP Tools	6 agent-ready tools (semantic, hybrid, RAG, ingest, delete, status)
⚡ Vector Search Latency	0.05 ms avg @ 10K docs (128-dim)
🔍 Keyword Search Latency	0.98 ms avg @ 100K docs
🧬 Hybrid Search Latency	0.17 ms avg @ 10K docs
🚀 Vector Throughput	18,800 queries/sec @ 10K
🧵 Concurrent Hybrid	14,000+ ops/sec @ 16 threads (384-dim)
🗜️ IVF-PQ + TurboQuant	8–32× memory reduction
✅ Test Suite	331+ tests, all passing
📦 Dependencies	Zero (JDK only)

---

🗺️ Quick Navigation

🚀 Getting Started

Page	Description
[[Getting Started	Getting-Started--Quickstart]]
[[What is Spector	About]]
[[JDK API Status	Getting-Started--Jdk-Api-Status]]
FAQ	Common questions answered

🤖 Agent Integration (MCP)

Page	Description
[[MCP Integration Architecture	Architecture--Mcp-Integration]]
[[MCP Server Guide	Sdk-Usage--Mcp-Server]]

🏗️ Architecture & Concepts

Page	Description
[[Architecture Overview	Architecture--Overview]]
[[Core Concepts	Architecture--Core-Concepts]]
[[Ingestion Pipeline	Architecture--Ingestion-Pipeline]]
[[RAG Pipeline	Architecture--Rag-Pipeline]]
[[Distributed Mode	Architecture--Distributed-Mode]]
[[GPU Acceleration	Architecture--Gpu-Acceleration]]

📖 Reference

Page	Description
[[REST API Reference	Api-Reference--Rest-Endpoints]]
[[Java SDK Guide	Sdk-Usage--Java-Client]]
[[Spring AI Integration	Sdk-Usage--Spring-Ai]]
[[CLI Reference	Cli-Reference--Spectorctl]]
[[Configuration Guide	Configuration--Parameters]]

⚙️ Operations & Community

Page	Description
[[Performance Tuning	Operations--Performance-Tuning]]
[[Contributing	Operations--Contributing]]

---

💡 Highlights at a Glance

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

Loading

Tip

New here? Start with Getting Started 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	18 Maven modules
Dependencies	Zero (JDK only)
SIMD	AVX2 / AVX-512 / NEON
GPU	CUDA via Panama FFM
MCP	Built-in, 6 agent-ready tools
Distributed	gRPC fan-out + consistent hashing

---

Built with ⚡ by Spectrayan · GitHub · Apache 2.0 · BSL 1.1 (memory)