NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #3063 by repository stars
Latest stable
v1.0.2
Last release 11 months ago
25 Dec 2025
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 4 of 4 stable releases
Nothing withdrawn
no release was ever pulled
12 months old
5 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
NornicDB support should be fully operational now.
NornicDB support should be fully operational now.
CHANGELOG.md at repository root for release history and guidance.src/api/chat-api.ts: Use database-aware default for semantic similarity (NornicDB = 0.5, Neo4j = configured default) so server-side embeddings use the correct threshold.testing/file-indexer-nornicdb.test.ts: Mock improvements for EmbeddingsService exports and corrected expectations to match NornicDB behavior.file-indexer-nornicdb tests).v1.0.1: additional nornicDB enhancements
Your coding agent can read these notes before it upgrades. Set up the MCP server →
v1.0.1: additional nornicDB enhancements
db.index.vector.queryNodes so the server generates embeddings.LIMIT is respected by server-side queries.0.5, Neo4j default = 0.75.UnifiedSearchService (mocked) pass (19 tests).RUN_LIVE_TESTS=true (15 tests).src/managers/UnifiedSearchService.ts — NornicDB hybrid search, threshold and commentssrc/api/chat-api.ts — use NornicDB-specific threshold when initiating semantic searchessrc/managers/GraphManager.ts — comment cleanupsrc/types/IGraphManager.ts — comment cleanuptesting/nornicdb-live-integration.test.ts — skip-by-default with RUN_LIVE_TESTSTagged as v1.0.1 (annotated tag): "v1.0.1: additional nornicDB enhancements"
For full details, see the commits between v1.0.0 and v1.0.1.
NornicDB now includes a native macOS installer with a beautiful menu bar app for easy management!
NornicDB now includes a native macOS installer with a beautiful menu bar app for easy management!
Five dedicated configuration tabs:
/security pagemodels/ directory.gguf files~/.nornicdb/config.yamlNornicDB-1.0.0-arm64.pkg (or .dmg)That's it! 🎉
After installation, the First-Run Wizard appears automatically:
Select a configuration preset:
Configure authentication and encryption:
adminpassword)Click the NornicDB icon in your menu bar to access:
http://localhost:7474Press ⌘, or select Settings... from the menu to configure NornicDB.
Toggle major features on/off:
Select AI models for different features:
.gguf modelsAll changes require a server restart - Click Save & Restart Server to apply.
Location: ~/.nornicdb/config.yaml
This is the main configuration file. The menu bar app reads and writes to this file.
~/.nornicdb/config.yaml (highest priority)./nornicdb.yaml (binary directory)./config.yaml (current directory)server:
bolt_port: 7687
port: 7474
host: "0.0.0.0"
auth:
username: "admin"
password: "password"
jwt_secret: "your-secret-here"
embedding:
enabled: true
provider: "ollama"
model: "bge-m3"
kmeans:
enabled: true
auto_tlp:
enabled: false
heimdall:
enabled: true
model: "qwen2.5-0.5b-instruct"
models_dir: "/usr/local/var/nornicdb/models"
database:
encryption_password: "" # Set to enable encryption
NornicDB binary is installed at /usr/local/bin/nornicdb
# Start server manually
nornicdb serve
# With custom config
nornicdb serve --config ~/.nornicdb/config.yaml
# Specify ports
nornicdb serve --bolt-port 7687 --http-port 7474
# Check version
nornicdb version
# View help
nornicdb --help
# Check service status
launchctl list | grep nornicdb
# Manually start service
launchctl start com.nornicdb.server
# Manually stop service
launchctl stop com.nornicdb.server
# Restart service
launchctl kickstart -k gui/$(id -u)/com.nornicdb.server
# View logs
tail -f /usr/local/var/log/nornicdb/stdout.log
tail -f /usr/local/var/log/nornicdb/stderr.log
/usr/local/bin/nornicdb # Binary
/usr/local/var/nornicdb/ # Data directory
├── data/ # Database files
└── models/ # AI models (.gguf files)
/usr/local/var/log/nornicdb/ # Log files
├── stdout.log
└── stderr.log
/Applications/NornicDB.app # Menu bar app
~/.nornicdb/ # User config
├── config.yaml # Configuration
└── .first_run # First-run flag
~/Library/LaunchAgents/ # Auto-start config
├── com.nornicdb.server.plist # Server service
└── com.nornicdb.menubar.plist # Menu bar app
The default credentials (admin / password) should be changed immediately:
For sensitive data:
For external services (MCP servers, automation):
http://localhost:7474/security (requires admin login)Authorization: Bearer <token>To completely remove NornicDB:
# Run uninstall script
/usr/local/bin/nornicdb-uninstall
# Or manually:
launchctl unload ~/Library/LaunchAgents/com.nornicdb.server.plist
launchctl unload ~/Library/LaunchAgents/com.nornicdb.menubar.plist
rm ~/Library/LaunchAgents/com.nornicdb.*.plist
rm -rf /usr/local/var/nornicdb
rm -rf /usr/local/var/log/nornicdb
rm /usr/local/bin/nornicdb
rm -rf /Applications/NornicDB.app
rm -rf ~/.nornicdb
Check logs:
tail -n 50 /usr/local/var/log/nornicdb/stderr.log
Common causes:
Solution:
# Check port usage
lsof -i :7687
lsof -i :7474
# Fix permissions
sudo chown -R $(whoami) /usr/local/var/nornicdb
# Reset database (⚠️ destroys data)
rm -rf /usr/local/var/nornicdb/data
Check if app is running:
ps aux | grep NornicDB
Restart menu bar app:
killall NornicDB
open /Applications/NornicDB.app
Verify credentials:
cat ~/.nornicdb/config.yaml | grep -A3 "^auth:"
Default credentials:
adminpasswordReset to defaults (edit ~/.nornicdb/config.yaml):
auth:
username: "admin"
password: "password"
Then restart server from menu bar.
Check feature flags:
cat ~/.nornicdb/config.yaml | grep "enabled:"
Enable embeddings:
Download models:
~/.nornicdb/.first_run and reopen appManual download:
# BGE-M3 embedding model
curl -L "https://huggingface.co/nornicAI/bge-m3-GGUF/resolve/main/bge-m3-Q8_0.gguf" \
-o /usr/local/var/nornicdb/models/bge-m3.gguf
# Qwen2.5 LLM
curl -L "https://huggingface.co/nornicAI/Qwen2.5-0.5B-Instruct-GGUF/resolve/main/qwen2.5-0.5b-instruct-q8_0.gguf" \
-o /usr/local/var/nornicdb/models/qwen2.5-0.5b-instruct.gguf
When reporting issues, include:
sw_versnornicdb version/usr/local/var/log/nornicdb/stderr.logcat ~/.nornicdb/config.yaml (redact passwords!)bolt://localhost:7687http://localhost:7474Thank you for choosing NornicDB! 🚀
The next-generation graph database that's faster than Neo4j, easier to use, and AI-powered.
Status: Production-ready baseline - Preserved in v2.0.0
Proven Performance:
What Makes It Work (DO NOT CHANGE):
Known Gaps (Can improve):
Target for next version: 90+ (Tier S) by addressing gaps WITHOUT breaking what works
Release v0.1.0 - async lambdas
Release v0.1.0 - async lambdas
One column per month.