Skip to content

lyonzin/knowledge-rag

v3.3.0 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 1mo MCP Developer Tools
✓ 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

Affected surfaces

deps

Summary

AI summary

All settings are now customizable via config.yaml with domain presets and a documented example.

Full changelog

What's New

YAML Configuration System

All settings are now customizable via config.yaml — no more editing Python code. Categories, keyword routing, query expansions, models, chunking, and paths are all configurable through a single YAML file.

Domain Presets

Four ready-to-use presets ship with the project:

| Preset | Categories | Keywords | Expansions | Best For |
|--------|-----------|----------|-----------|----------|
| cybersecurity | 8 | 200+ | 69 | Red/Blue Team, CTFs, threat hunting |
| developer | 9 | 150+ | 50+ | Full-stack, APIs, DevOps, cloud |
| research | 9 | 100+ | 40+ | Academic papers, thesis, datasets |
| general | 0 | 0 | 0 | Blank slate, pure semantic search |

cp presets/developer.yaml config.yaml   # Ready to go

Generic Use Support

With empty mappings ({}), the system operates as a domain-agnostic semantic search engine. No security-specific logic unless you want it.

Backwards Compatible

No config.yaml? The system uses built-in defaults — identical behavior to v3.2.x. Zero migration required.

Changes

  • NEW: YAML configuration system — fully customizable via config.yaml
  • NEW: Domain presets — cybersecurity, developer, research, general
  • NEW: config.example.yaml — documented template with explanations for every field
  • NEW: Categories, keyword routing, and query expansions now user-configurable
  • NEW: Empty config = pure semantic search with zero domain logic
  • NEW: Warning log for empty files during indexing (previously silent skip)
  • IMPROVED: README rewritten — full configuration reference, preset docs, updated structure
  • IMPROVED: pyyaml added as dependency

Upgrade

git pull origin master
pip install pyyaml    # New dependency
# Optionally: cp presets/cybersecurity.yaml config.yaml

No breaking changes. Existing installations work without any config file.

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

Track lyonzin/knowledge-rag

Get notified when new releases ship.

Sign up free

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 →

Beta — feedback welcome: [email protected]