# NornicDB Documentation
Welcome to **NornicDB** - A production-ready graph database with GPU acceleration, Neo4j compatibility, and advanced AI integration.
## π Quick Start Paths
### New to NornicDB?
π **[Getting Started Guide](getting-started/)** - Installation and first queries in 5 minutes
### Migrating from Neo4j?
π **[Neo4j Migration Guide](neo4j-migration/)** - 96% feature parity, easy migration
### Building AI Agents?
π **[AI Integration Guide](ai-agents/)** - Cursor, MCP, and agent patterns
### Need API Reference?
π **[API Documentation](api-reference/)** - Complete function reference
---
## π Documentation Sections
### For Users
- **[Getting Started](getting-started/)** - Installation, quick start, first queries
- **[User Guides](user-guides/)** - Cypher queries, vector search, transactions
- **[API Reference](api-reference/)** - Complete function and endpoint documentation
- **[Features](features/)** - Memory decay, GPU acceleration, link prediction
### For Developers
- **[Architecture](architecture/)** - System design, storage engine, query execution
- **[Performance](performance/)** - Benchmarks, optimization, GPU acceleration
- **[Advanced Topics](advanced/)** - K-Means clustering, embeddings, custom functions
- **[Development](development/)** - Contributing, testing, code style
### For Operations
- **[Operations Guide](operations/)** - Deployment, monitoring, backup, scaling
- **[Security Guide](security/)** - HTTP security, CSRF/SSRF/XSS protection
- **[Clustering Guide](user-guides/clustering.md)** - Hot Standby, Raft, Multi-Region
- **[Compliance](compliance/)** - GDPR, HIPAA, SOC2, encryption, audit logging
### For AI Integration
- **[AI Agents](ai-agents/)** - Cursor integration, chat modes, MCP tools
- **[Neo4j Migration](neo4j-migration/)** - Feature parity, migration guide
## π― Key Features
### π§ Graph-Powered Memory
- Semantic relationships between data
- Multi-hop graph traversal
- Automatic relationship inference
- Memory decay simulation
### π GPU Acceleration
- 10-100x speedup for vector search
- Multi-backend support (CUDA, OpenCL, Metal, Vulkan)
- Automatic CPU fallback
- Memory-optimized embeddings
### π Advanced Search
- Vector similarity search with cosine similarity
- Full-text search with BM25 scoring
- Hybrid search (RRF) combining both methods
- Cross-encoder reranking (Stage 2 retrieval)
- MMR diversification for result variety
- HNSW indexing for O(log N) performance
- Eval harness for search quality validation
### π Neo4j Compatible
- Bolt protocol support
- Cypher query language
- Standard Neo4j drivers work out-of-the-box
- Easy migration from Neo4j
### π Enterprise-Ready
- **High Availability** - Hot Standby, Raft consensus, Multi-Region
- **Security Middleware** - CSRF/SSRF/XSS protection on all HTTP endpoints
- **WAL Auto-Compaction** - Automatic snapshots prevent unbounded disk growth
- GDPR, HIPAA, SOC2 compliance
- Field-level encryption
- RBAC and audit logging
- ACID transactions
## π Documentation Statistics
- **21 packages** fully documented
- **13,400+ lines** of GoDoc comments
- **350+ functions** with examples
- **40+ ELI12 explanations** for complex concepts
- **4.1:1 documentation-to-code ratio**
## π― Popular Topics
- [HTTP Security Guide](security/http-security.md) β **NEW**
- [WAL Compaction Guide](operations/wal-compaction.md) β **NEW**
- [Durability Configuration](operations/durability.md) β **NEW**
- [Clustering & High Availability](user-guides/clustering.md)
- [Vector Search Guide](user-guides/vector-search.md)
- [Hybrid Search (RRF)](user-guides/hybrid-search.md)
- [GPU Acceleration](features/gpu-acceleration.md)
- [Memory Decay System](features/memory-decay.md)
- [Cypher Function Reference](api-reference/cypher-functions/)
- [Benchmarks vs Neo4j](performance/benchmarks-vs-neo4j.md)
- [Docker Deployment](getting-started/docker-deployment.md)
- [Feature Flags](features/feature-flags.md)
## π Project Status
- **Version:** 1.0.0 π
- **Status:** Production Ready β
- **Docker:** `timothyswt/nornicdb-arm64-metal:latest`
- **[Changelog](CHANGELOG.md)** - Version history and release notes
## π€ Contributing
Found an issue or want to improve documentation? Check out our [Contributing Guide](CONTRIBUTING.md).
## π License
NornicDB is MIT licensed. See [LICENSE](../LICENSE) for details.
---
**Last Updated:** December 4, 2025
**Version:** 1.0.0 π
**Docker:** `timothyswt/nornicdb-arm64-metal:latest`
**Status:** Production Ready β