Installation

Pre-built binaries coming soon

MuninnDB pre-built binaries for macOS, Linux, and Windows will be published with the v0.1.0 release. Until then, build from source (requires Go 1.23+).

Build from Source

Prerequisites: Go 1.23 or newer. No other tools required.

bash

# Clone the repository
git clone https://github.com/scrypster/muninndb
cd muninndb

# Build (produces a single binary ~20MB)
go build -o muninndb ./cmd/muninndb

# Verify
./muninndb --version
# MuninnDB v0.1.0 (go1.23, darwin/amd64)

# Install to PATH (optional)
sudo mv muninndb /usr/local/bin/

Configuration

MuninnDB works with zero configuration out of the box. All defaults are sensible for development. For production, create a muninndb.yaml in the working directory:

muninndb.yaml

server:
  mbp_port:  8747
  grpc_port: 8748
  rest_port: 8749
  ui_port:   8750
  data_dir:  ./data

cognitive:
  decay_interval:    5m      # How often decay runs
  hebbian_interval:  1m      # How often Hebbian updates run
  decay_floor:       0.05    # Minimum relevance score

cache:
  l1_max_entries: 10000      # Hot engrams in memory

auth:
  require_key: true          # Set false for local dev

First Run

bash

muninndb serve

# MuninnDB v0.1.0 starting
# data dir: ./data
# MBP   :8747  ✓
# gRPC  :8748  ✓
# REST  :8749  ✓
# Web   :8750  ✓ → http://localhost:8750
# Cognitive workers: decay(5m) hebbian(1m) confidence(10m)
# Ready.