$git clone https://github.com/orneryd/NornicDBOpen http://localhost:7474 for the admin UI. For NVIDIA CUDA hosts, use timothyswt/nornicdb-amd64-cuda-bge:latest. For Vulkan hosts, use timothyswt/nornicdb-amd64-vulkan-bge:latest.
| 1 | <p align="center"> |
| 2 | <img src="https://raw.githubusercontent.com/orneryd/NornicDB/refs/heads/main/docs/assets/logos/nornicdb-logo.svg" alt="NornicDB Logo" width="200"/> |
| 3 | </p> |
| 4 | |
| 5 | <h1 align="center">NornicDB</h1> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <strong>Graph, vector, and historical truth in one database</strong><br/> |
| 9 | Neo4j-compatible • Hybrid graph + vector retrieval • Historical reads via MVCC<br/> |
| 10 | <em>Achieving Psygnosis for AI</em> |
| 11 | <p align="center"> |
| 12 | Multi-arch support: CPU | CUDA | Metal | Vulkan |
| 13 | <p align="center"> |
| 14 | </p> |
| 15 | |
| 16 | <p align="center"> |
| 17 | <img src="https://img.shields.io/badge/version-1.1.11-success" alt="Version 1.1.11"> |
| 18 | <a href="https://coveralls.io/github/orneryd/NornicDB?branch=main"><img src="https://coveralls.io/repos/github/orneryd/NornicDB/badge.svg?branch=main" alt="Coveralls Report"></a> |
| 19 | <a href="https://hub.docker.com/u/timothyswt"><img src="https://img.shields.io/badge/Docker%20Pulls-25K%2B-blue" alt="Docker"></a> |
| 20 | <a href="https://neo4j.com/"><img src="https://img.shields.io/badge/neo4j-compatible-008CC1?logo=neo4j" alt="Neo4j Compatible"></a> |
| 21 | <a href="https://github.com/qdrant/qdrant"><img src="https://img.shields.io/badge/qdrant-compatible-008CC1?logo=qdrant" alt="Qdrant Compatible"></a> |
| 22 | <a href="https://go.dev/"><img src="https://img.shields.io/badge/go-%3E%3D1.26-00ADD8?logo=go" alt="Go Version"></a> |
| 23 | <a href="https://goreportcard.com/report/github.com/orneryd/nornicdb"><img src="https://goreportcard.com/badge/github.com/orneryd/nornicdb" alt="Go Report Card"></a> |
| 24 | <a href="LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a> |
| 25 | </p> |
| 26 | <p align="center"> |
| 27 | <a href="https://discord.gg/yszYHrxp4N"><img src="https://img.shields.io/badge/discord-community-00ADD8?logo=discord" alt="Discord Community Server"></a> |
| 28 | </p> |
| 29 | |
| 30 | <p align="center"> |
| 31 | <a href="#quick-start">Quick Start</a> • |
| 32 | <a href="#what-nornicdb-is">What It Is</a> • |
| 33 | <a href="#why-nornicdb-is-different">Why NornicDB</a> • |
| 34 | <a href="#performance-snapshot">Benchmarks</a> • |
| 35 | <a href="#features">Features</a> • |
| 36 | <a href="#documentation">Docs</a> • |
| 37 | <a href="#comparison">Comparison</a> • |
| 38 | <a href="#contributors">Contributors</a> |
| 39 | </p> |
| 40 | |
| 41 | [](https://oosmetrics.com/repo/orneryd/NornicDB) |
| 42 | |
| 43 | ## Quick Start |
| 44 | |
| 45 | ```bash |
| 46 | # Homebrew |
| 47 | brew tap --trust orneryd/nornicdb && brew install nornicdb && brew services start nornicdb |
| 48 | |
| 49 | # arm64 / Apple Silicon |
| 50 | docker run -d --name nornicdb -p 7474:7474 -p 7687:7687 -v nornicdb-data:/data timothyswt/nornicdb-arm64-metal-bge:latest |
| 51 | |
| 52 | # amd64 / CPU only |
| 53 | docker run -d --name nornicdb -p 7474:7474 -p 7687:7687 -v nornicdb-data:/data timothyswt/nornicdb-amd64-cpu-bge:latest |
| 54 | ``` |
| 55 | |
| 56 | Open [http://localhost:7474](http://localhost:7474) for the admin UI. For NVIDIA CUDA hosts, use `timothyswt/nornicdb-amd64-cuda-bge:latest`. For Vulkan hosts, use `timothyswt/nornicdb-amd64-vulkan-bge:latest`. |
| 57 | |
| 58 | --- |
| 59 | |
| 60 | > Note: Docker on macOS does not expose Metal acceleration. The Apple Silicon image still runs, but GPU acceleration on macOS requires a native install from the [releases page](https://github.com/orneryd/NornicDB/releases) or a local build. |
| 61 | |
| 62 | --- |
| 63 | |
| 64 | > **Writing queries?** Start with the [Hot-Path Cypher Cookbook](docs/performance/hot-path-query-cookbook.md) — proven query shapes that route through the executor's specialized fast paths. |
| 65 | > |
| 66 | > 🤖 **Building with Claude / agents?** The [`docs/skills/`](docs/skills/) directory contains agent-ready skill files for every Cypher surface: query shapes, decay/promotion policies, managed embeddings, vector & hybrid search, and RAG procedures. Drop them into `.claude/skills/` to make agents fluent in NornicDB. |
| 67 | |
| 68 | ## What NornicDB Is |
| 69 | |
| 70 | NornicDB is a graph database for workloads that need graph traversal, vector retrieval, and historical truth in the same system. It speaks Neo4j's language through Bolt and Cypher, exposes REST, GraphQL, and gRPC interfaces, and can preserve Qdr |