Research your documents. Trust every answer.

knownote.pages.dev · 2026-09-28 · by Long Nguyen ·generic
A desktop workspace for reading, questioning and understanding your own documents. Local-first, source-backed answers, and any model you choose. No Docker, no server, no account.

Research your documents. Trust every answer.

Research your documents. Trust every answer.

A local-first desktop workspace for reading and questioning your own sources. Every answer carries the passage it came from, and retrieval runs on your machine — not in someone else's cloud.

Install KnowNoteGitHub

Windows x64 · macOS Apple Silicon · unsigned, one prompt on first launch

The KnowNote window: a knowledge library on the left listing imported documents with their chunk counts, a chat pane in the middle showing a question and a structured answer, and a note pane on the right holding the note being written.

The library, the question and the note. Real application, real window.

  • ## Local-first
  • Your documents, notebooks and embeddings stay on your machine — the embedder runs inside the app, so retrieval works offline.
  • ## Traceable
  • Every answer keeps the source passage behind it, with its place in the document recorded.
  • ## Lightweight
  • Download, open, start reading. No Docker, no server, no account.

    A citation is only worth something if it lands somewhere. Point at the marker and the thread runs back to the passage behind the answer.

    handbook.pdf p. 14

    1. 01Retrieval quality is a property of the whole pipeline, not of the 2. 02vector store. A passage cut in the middle of a sentence retrieves 3. 03badly and quotes worse, and no amount of tuning at the ranking step 4. 04recovers the meaning the split destroyed. Keeping the boundaries the 5. 05document already had costs almost nothing at import time.

    Answer

    Splitting is where retrieval quality is decided. A passage cut mid-sentence is poor to retrieve and worse to quote, so the fix belongs at import time1.

    The passage records where it began and ended in the extracted text, so the citation points at the passage, not the whole file.

    A notebook accumulates questions before it accumulates answers. Open one to see what the answer rests on, the passage behind it, and what you concluded.

    Why does retrieval quality degrade?4 sources · 12 citations

    Answer

    Because the passage boundaries were decided before retrieval ran. A split that lands mid-sentence misleads both retrieval and every quotation taken from it.

    Sources

  • handbook.pdf
  • survey-2024.pdf
  • notes-week-3.docx
  • draft-methods.pdf
  • Passage in the original

    cited span · 12 citations point here

    A passage cut in the middle of a sentence retrieves badly and quotes worse, and tuning the ranking step cannot recover the meaning the split destroyed.

    Note

    Boundaries are an import decision, not a ranking one.

    Dense retrieval, or BM25?6 sources · 18 citations

    Answer

    Both sources favour dense retrieval on semantic queries, and BM25 wherever the query shares a rare term. The disagreement is mostly about the corpus.

    Sources

  • survey-2024.pdf
  • benchmark-notes.pdf
  • course-reader.pdf
  • slides-w7.pptx
  • blog-post.html
  • draft-methods.pdf
  • Passage in the original

    cited span · 18 citations point here

    Hybrid scoring recovered most of the gap on the out-of-domain split, which suggests the dense component carried semantics and the sparse component carried rare terms.

    Note

    Compare the two on one corpus. Two corpora is not a comparison.

    How does attention scale with sequence length?3 sources · 9 citations

    Answer

    Quadratically in the sequence dimension. Every source treats that as the constraint to design around, so the work is in what replaces the full matrix.

    Sources

  • attention-paper.pdf
  • efficient-transformers.pdf
  • course-reader.pdf
  • Passage in the original

    cited span · 9 citations point here

    The cost of attention grows with the square of the sequence length, so the practical ceiling is memory rather than compute.

    Note

    The ceiling is memory. That reframes the efficiency literature.

    What evidence would change my mind?5 sources · 21 citations

    Answer

    A run on the same corpus where the sparse baseline matches the hybrid, or a hybrid result that holds without the rare-term queries. Neither is in this notebook.

    Sources

  • draft-methods.pdf
  • survey-2024.pdf
  • notes-week-3.docx
  • benchmark-notes.pdf
  • rebuttal.pdf
  • Passage in the original

    cited span · 21 citations point here

    Ablating the sparse component left the aggregate score within two points, but the per-query breakdown is not reported.

    Note

    Aggregate scores hide this. Ask for the per-query table.

    Which methods do these papers share?4 sources · 24 citations

    Answer

    Three of the four share an early pooling step and differ only afterwards. The fourth is structurally different, so its numbers are not comparable.

    Sources

  • survey-2024.pdf
  • attention-paper.pdf
  • efficient-transformers.pdf
  • benchmark-notes.pdf
  • Passage in the original

    cited span · 24 citations point here

    All three recover a fixed-width representation before any scoring, which makes their differences a matter of what happens next rather than how the input is read.

    Note

    The odd one out is the interesting one.

    Illustrative, written for this page.

    1. Drop in your sourcesEach format has its own parser, so page and slide structure survive.pdf · docx · pptx · http 2. Ask questionsIn your own words. Retrieval is multilingual.your notebook only 3. Verify the evidenceEvery answer points back at the passage behind it.citation → passage 4. Build your notesWhat you concluded stays beside the sources.structured · local

    No bundled chat model and no account of ours. Add any OpenAI-, Anthropic- or Google-compatible endpoint, or a local server such as Ollama. The credential stays on disk; retrieval needs no model.

  • OpenAIendpoint
  • Geminiendpoint
  • Claudeendpoint
  • DeepSeekendpoint
  • Ollamalocal server
  • Any compatibleendpoint
  • Built-in local embedderships with the app

modelmultilingual-e5-smallrevision761b726ddtypeq8dims384

the one model that ships · retrieval only, not chat

The repository is the project. The numbers below were read from it.

Stars1,101

Forks147

Open issues25

LicenceGPL-3.0

Every issue, pull request and release is public. What is not shipped yet is on the download page.

View sourceReleases

Your sources. Your questions. Your knowledge.

One screen asks you for anything — a model connection. The embedder is already here.

Install KnowNoteAll releases

knownote.pages.dev · 2 images · 17 links

Comments (0)

No comments yet