SkillAgentSearch skills...

LORE

Ask questions about the books you own: an AI reader that turns e-books into a knowledge graph and answers with every sentence cited, without spoilers past your chapter. GraphRAG + MCP.

Install / Use

claude mcp add Jatin-Roopchandani -- npx -y github:Jatin-Roopchandani/LORE

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

79/100

Supported Platforms

Claude Code
Claude Desktop
Gemini CLI

Our assessment of LORE

LORE scores 79/100 on our quality scale, 780th of 942 AI & Machine Learning skills we index.

Its MCP Server is 7.4 KB long, well organised into 15 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.

It has 45 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
7/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so LORE is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

LORE compared with similar skills

All 4 of these similar skills score higher than LORE; compare them before choosing.

SkillScoreStarsUpdatedFormat
LORE (this skill)by Jatin-Roopchandani7945todayMCP Server
claude-memby thedotmack100118.1ktodayCLAUDE.md
Agent-Reachby Panniantong100112.9k10d agoCLAUDE.md
Understand-Anythingby Egonex-AI10093.1ktodayCLAUDE.md
hyperframesby heygen-com10086.2ktodayCLAUDE.md

Frequently asked questions

How do I install LORE?
Run claude mcp add Jatin-Roopchandani -- npx -y github:Jatin-Roopchandani/LORE. The install tabs above show the steps for each supported agent.
Which AI agents does LORE work with?
It is written for Claude Code, Claude Desktop and Gemini CLI, as a MCP Server file. Other agents that read the same format can often use it too.
Is LORE safe to use?
It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is LORE still maintained?
The repository was last updated today, so LORE is actively maintained.
<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/brand/lore-lockup-dark.svg"> <img src="docs/brand/lore-lockup.svg" alt="LORE" width="260"> </picture> </p> <p align="center"> <strong>Ask questions about the books you own.</strong><br> Every sentence cited from the text. Nothing past the chapter you're on. </p> <p align="center"> <a href="https://github.com/Jatin-Roopchandani/LORE/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Jatin-Roopchandani/LORE/actions/workflows/ci.yml/badge.svg"></a> <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue.svg"></a> <img alt="Python 3.12+" src="https://img.shields.io/badge/python-3.12%2B-blue.svg"> <a href="https://lore.jrvn.site"><img alt="Try it live" src="https://img.shields.io/badge/try%20it-lore.jrvn.site-f0a03c.svg"></a> </p> <p align="center"> <a href="https://lore.jrvn.site">Live beta</a> · <a href="docs/guide.md">User guide</a> · <a href="docs/how-it-works.md">How it works</a> · <a href="https://lore.jrvn.site/blog">Blog</a> · <a href="https://github.com/Jatin-Roopchandani/LORE/issues">Issues</a> </p> <p align="center"> <img src="docs/images/graph-search.gif" alt="LORE answering a question: the knowledge graph lights up as it searches" width="900"> </p>

LORE is an open-source AI reader for your e-books. It turns each book into a knowledge graph of its characters, places, groups and events, then answers your questions from the text itself: every sentence in an answer cites the passage it comes from, and a second pass checks each one against that passage and cuts what the book doesn't say. Tell it how far you've read, and it never looks past your chapter.

Features

  • Answers you can check. Every sentence cites its passage; click a citation to read it in the book.
  • Spoiler-safe. Set your reading progress per book. Answers, the graph, character profiles and timelines all stop at your chapter, enforced at retrieval, so the model never sees what comes later.
  • Questions across a series. How a character changes from book one to book five, how a world or magic system works, who knows whom.
  • Deep dives. Long, sectioned analyses with LORE's reading, the other side, and what the books leave open, all cited.
  • Explore the graph. Click any character for a profile, a story timeline and their relationships, each with the passage behind it.
  • Bring your own model. Gemini (the free tier works), Claude or OpenAI for reading and writing; embeddings run locally on Ollama.
  • Use it from Claude. An MCP server lets claude.ai, Claude Desktop, Claude Code or any MCP client search your library and ask LORE questions.
  • Private by design. Self-host it on your own machine, or use the hosted beta where each reader's library is kept separately.
<p align="center"> <img src="docs/images/answer.png" alt="A cited answer to 'How did Dr. Watson meet Holmes?' beside the graph of the relationships it used" width="900"> </p>

Try it

The fastest way is the hosted beta at lore.jrvn.site: request an invite on the homepage. New accounts start with A Study in Scarlet already processed, so you can ask questions straight away. You'll need a free Gemini API key (or a Claude or OpenAI key); the app walks you through it.

Run it yourself

With Docker, for you and the people you add:

curl -fsSLO https://raw.githubusercontent.com/Jatin-Roopchandani/LORE/main/docker-compose.yml
docker compose up -d
docker compose logs lore | grep "setup code"   # a one-time code
# open http://localhost:8080, enter the code and create the admin account

Choose the AI model on the admin page: Gemini, Claude or OpenAI with your key, or a model you run yourself (llama.cpp's llama-server, vLLM, LM Studio, Ollama). Each person you add gets their own private library. The self-hosting guide covers requirements, a local model step by step, adding people, upgrades, backups, HTTPS and troubleshooting.

From source

For development, or a single-user install with no Docker.

Prerequisites: Python 3.12+, uv, Node.js 18+ and Ollama.

# 1. The local embedding model (keep Ollama running)
ollama pull nomic-embed-text

# 2. A model key: a free Gemini key from https://aistudio.google.com/apikey
export GEMINI_API_KEY=your-key-here

# 3. Install, and check everything is in place
git clone https://github.com/Jatin-Roopchandani/LORE.git
cd LORE
uv sync
uv run lore doctor

# 4. Build the web app (once)
cd web && npm install && npm run build && cd ..

# 5. Start it
uv run lore ui

Open http://127.0.0.1:8766, click + Add book, and choose an EPUB or PDF you own. The Library panel shows processing as it goes (a novel takes a while on Gemini's free tier); when it's done, ask away.

Prefer the command line? lore ingest, lore process and lore ask do the same; see the user guide. Instead of the environment variable, the key can also live in ~/.config/lore/gemini.env (mode 600).

No cloud key? Run every step on your own model (llama-server, vLLM, LM Studio or Ollama): see Running fully local.

Use it from Claude

LORE runs an MCP server, so Claude can search your library and ask LORE questions with your reading position applied:

  • Hosted beta: in claude.ai, open Settings → Connectors → Add custom connector and paste https://lore.jrvn.site/mcp.
  • Self-hosted: run uv run lore mcp (stdio) or uv run lore mcp --http.

Step by step: Use your ebook library in Claude and the user guide.

How it works

book (EPUB/PDF) → chapters & passages → LLM extraction → entity resolution
               → Kuzu graph + LanceDB vectors

question → split into parts → starting entities → graph walk → passages
         → claims, each quoting a passage → check every claim → cited prose

Reading progress becomes a per-book chapter cap applied as a prefilter on every vector search, graph query and profile, so later chapters are never retrieved. Behaviour changes ship behind switches, each judged by blind paired evals on held-out questions. The full pipeline, models and design decisions are in How LORE works.

<p align="center"> <img src="docs/images/deep-dive.png" alt="A deep dive into Holmes' investigative methods: a short answer, contents, and cited sections" width="900"> </p>

Stack: Python, FastAPI, Kuzu (graph), LanceDB (vectors), SQLite and Postgres, Ollama (embeddings), React and TypeScript. The hosted beta runs on Docker Compose behind a Cloudflare Tunnel (deploy/).

Project status

LORE is in beta. It works end to end on full novels and series, and the test suite (4,000+ server tests, 800 web tests) runs on every push. Known limits: answers are only as good as the extraction, long series take a while to process, and a book must be one you can upload as EPUB or PDF.

Contributing

Bug reports, ideas and pull requests are welcome. See CONTRIBUTING.md for setting up a development environment and running the tests. To report a security issue, please follow SECURITY.md rather than opening a public issue.

License

MIT © Jatin Roopchandani

Related Skills

View on GitHub
GitHub Stars45
CategoryAI
Updated6h ago
Forks5

Languages

Python

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info