This release includes breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+14 more
Affected surfaces
Summary
AI summaryAll 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:
pyyamladded 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
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.
Related context
Beta — feedback welcome: [email protected]