N

NenDB

Static-memory, crash-safe graph database with AI-native algorithms and HTTP API

v0.1.0-betaZigStatic Memory

Quick Start

Download and run the NenDB server quickly on Linux, macOS, Windows, or via Docker. Choose the lightweight static-binary approach for minimal resource usage.

Recommended — Prebuilt static binary

Fastest startup and lowest overhead. Download the correct release for your platform and run the single binary.

Downloads are automatically built and released via GitHub Actions CI/CD. Each release includes pre-compiled binaries for Linux, macOS, and Windows.

Install script (one-liner)
curl -fsSL https://github.com/Nen-Co/nen-db/releases/latest/download/nen-linux-x86_64.tar.gz | tar -xz

Or on Windows (PowerShell):

Invoke-WebRequest -Uri "https://github.com/Nen-Co/nen-db/releases/latest/download/nen-windows-x86_64.zip" -OutFile "nen-windows.zip"; Expand-Archive -Path "nen-windows.zip" -DestinationPath "."

Docker (optional)

If you prefer containerization or want to run multiple isolated instances, use Docker. Containers add overhead but simplify orchestration.

docker run --rm -p 9000:9000 --name nendb -v $(pwd)/data:/var/lib/nendb nenco/nendb:latest ./nendb serve

If you want minimal resource usage, prefer the static-binary above; Docker adds the container runtime footprint.

Build from source (developer)

Build locally using Zig and the repository sources. This is useful for development or when creating releases.

git clone https://github.com/Nen-Co/nendb.git cd nendb zig build -Doptimize=ReleaseSafe # produced binary will typically be in zig-out/bin/nendb ./zig-out/bin/nendb version

Cross-compilation and packaging for different OSes can be automated in CI — see ideas below.

  • Build static releases in CI (GitHub Actions) for each platform.
  • Sign and upload release artifacts to GitHub Releases or a CDN.
  • Provide the download URLs and a tiny install script: curl https://install.nen.ai | sh that downloads the appropriate binary for the host.

Recommendations

  • For minimal resources and best performance, publish static binaries per-OS and instruct users to download & run the binary directly.
  • Use Docker only where orchestration or isolation is required — it increases footprint.
  • Automate cross-platform packaging in CI and publish releases so the curl commands point to stable URLs.
Performance

Built with Zig for maximum performance and minimal memory overhead.

  • • Static memory allocation
  • • Zero dynamic allocations
  • • Crash-safe WAL operations
  • • Graph snapshots
🧠AI-Native

Designed specifically for AI workloads and graph reasoning.

  • • Built-in graph algorithms
  • • Vector similarity search
  • • GraphRAG support
  • • Real-time graph updates
🔌HTTP API

RESTful HTTP API for easy integration with any language.

  • • JSON over HTTP
  • • Graph CRUD operations
  • • Algorithm endpoints
  • • Streaming responses
🛡️Reliability

Enterprise-grade reliability with crash recovery and data integrity.

  • • ACID transactions
  • • Write-ahead logging
  • • Point-in-time recovery
  • • Data validation

Additional Resources

GitHub Repository

Source code and issues

Python Package

Install via pip

pip install nendb
Community

Get help and contribute