lyonzin/knowledge-rag

v3.7.0 Feature

This release adds 1 notable feature for engineering teams evaluating rollout.

Published 1mo MCP Developer Tools

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

antigravity claude claude-code claude-code-cli codex cursor-ai

+14 more

document-search hybrid-search inteligencia-artificial knowledge-base local-ai mcp mcp-server llm rag-chatbot rag-pipeline reranking retrieval-augmented-generation semantic-search vector-db

Summary

AI summary

ChromaDB preflight repair, offline reranker fallback, and virtualenv root detection fix improve resilience.

Full changelog

What's New

Resilience & Recovery

ChromaDB startup preflight — Probes ChromaDB in a child process before MCP initialization. If the persistent index causes a native segfault, the corrupted chroma_db/ and index_metadata.json are moved to data/backups/auto-repair-* and the server rebuilds cleanly on next startup.
Offline reranker fallback — If the cross-encoder reranker model is not cached and the machine is offline, search_knowledge now falls back to RRF ordering from hybrid semantic+BM25 retrieval instead of failing. Reranker remains enabled by default when the model is available.
Virtualenv root detection fix — Handles Python symlinks in venvs that resolve to the system interpreter (e.g., /usr/bin/python), which previously caused incorrect project root detection.

New

knowledge-rag-guarded console entry point (alias for default guarded startup).

Behavior

Normal behavior is unchanged when ChromaDB is healthy and the reranker model is cached. Changes only activate in failure/offline scenarios to keep the MCP server recoverable and usable.

Contributors

@Hohlas — PR #29

Full Changelog: https://github.com/lyonzin/knowledge-rag/compare/v3.6.2...v3.7.0

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track lyonzin/knowledge-rag

Get notified when new releases ship.

About lyonzin/knowledge-rag

Local RAG system for Claude Code with hybrid search (BM25 + semantic), cross-encoder reranking, markdown-aware chunking, query expansion, and 12 MCP tools. Runs entirely offline with zero external servers.

All releases →