Literature RAG

Local retrieval-augmented generation for your book library

🚧 Under construction

Asking a question

Always start with /literature prompt so it turns MCP on and understands you want RAG context

/literature.prompt (specify either book or topic/folder),  question

graph TD
  p1[literature prompt]
  m1[literature MCP]
  p1 --> m1
  m1 --> k1[Keyword detection]
  k1 --> f1[Select folder]
  f1 --> r1[RAG retrieval via llama index]
  r1 --> v1[VectorStore]
  r1 --> l1[Gemini LLM]
  l1 --> u1[Answer to user]

Loading

Adding, removing book

add, remove book under a folder/topic, then run update literature

graph TD
  a1[Add or remove EPUB] --> h1[Hammerspoon]
  h1 --> w1[Watchdog script]
  w1 --> idx1[Indexing]
  idx1 --> v2[VectorStore]
  w1 --> k2[Update .rag-topics]
  v2 --> s1[Persist to storage]

Loading

Roadmap

1. Embed books via update literature ✅
2. Turn on literature MCP (via tasks) ✅
3. Query via literature prompt ✅
4. Turn off literature MCP (via tasks) ✅
5. Local embedding model (vs gemini) ⏳
6. Better query (terminal on bg? extension?) ⏳
7. threading/multiprocessing for simultaneous queries and implement cache for recent responses. ⏳
8. literature prompt asking for topic or book for faster response ⏳
9. turn MCP on/off automatically (how?) ⏳
10. PDF support ⏳
11. generalize: path on .env, etc. new computers) ⏳
12. image support (source points to file with image) ⏳

🤖 For AI

Always use /opt/homebrew/bin/python3.11 (Homebrew's Python 3.11) to run scripts and install packages. Never use venv or virtual environments; always install globally.

Install dependencies with:

/opt/homebrew/bin/python3.11 -m pip install <package>

Run scripts with:

/opt/homebrew/bin/python3.11 script.py

Never use python3, python, pip, or pip3 without the full path. Review this notice before running any script or installing dependencies. Update this list with new findings as needed.

• All API keys are kept in .env and never exposed in config files or code.
• Only the Gemini API key is required for embedding and LLM.
• All code and data live in ~/Documents/literature for privacy and portability.