Skip to content

hearth v0.3.0 - Knowledge

Choose a tag to compare

View all tags
@EricFinland EricFinland released this 27 Jun 13:26
v0.3.0
d5dc47b

hearth v0.3.0 - "Knowledge"

hearth agents can now ground their answers in your own documents, fully local and private.

New: local knowledge base (RAG)

  • kb_add - ingest a document (inline text or a workspace file) into hearth's knowledge base. Re-ingesting a source updates it.
  • kb_search - retrieve the chunks most relevant to a query, so a local model can answer from your material instead of guessing.

Retrieval is pure-stdlib TF-IDF cosine similarity: no embedding model to pull, deterministic, works offline. The ranking sits behind a seam, so it can be upgraded to Ollama embeddings later without changing how agents use it. Everything lives in the local audit database; nothing leaves the box.

The tools respect permission modes (kb_search is a safe read; kb_add is an edit), so they behave correctly under plan / auto / bypass.

Notes

Still honest about the ceiling: TF-IDF is lexical retrieval, great for keyword-rich material and a solid base for semantic search later. As always, every run is audited and the system is reproducible from the flake. Docs: https://ericfinland.github.io/hearth/

Assets 2
Loading