prime-radiant-inc

prime-radiant-inc / books-for-bots

Public

Rust CLI that converts EPUBs to YAML-headed markdown with byte/line offsets per chapter, for token-efficient agent reading

33
2
100% credibility
Found May 02, 2026 at 27 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Transforms EPUB ebooks into a single Markdown file with YAML frontmatter listing chapter positions for precise, token-efficient access by AI agents.

How It Works

1
🔍 Discover the tool

You learn about a simple helper that turns regular ebooks into easy-to-read files for AI assistants.

2
💻 Set it up

You quickly add this converter to your computer so it's ready to use.

3
📚 Choose your ebook

Pick the ebook file from your collection that you want your AI to enjoy.

4
⚡ Make the magic happen

Run the converter on your book and watch it create a smart single file with chapter guides.

5
📁 Grab your new file

Open the output folder to find the new book file and any pictures, all neatly organized.

🎉 AI reads like a pro

Your AI helper now jumps straight to any chapter, reading the whole book smoothly and efficiently.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 27 to 33 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is books-for-bots?

Books-for-bots is a Rust CLI tool that converts EPUB files into a single Markdown file topped with YAML frontmatter listing every chapter's title, byte offset, and line number. It solves the nightmare of feeding books to LLM agents: no more unzipping zips, parsing manifests, or chasing spine links—agents can seek directly via `dd if=book.md bs=1 skip=OFFSET`. Output includes extracted images in an `images/` subdir, GFM tables, footnotes, and code blocks, all deterministic and faithful to the source.

Why is it gaining traction?

Unlike generic EPUB converters, it prioritizes token efficiency for bots with absolute offsets as a navigation API, skipping EPUB cruft like running headers or Calibre artifacts. As a lean rust cli tool using clap for args, it installs via `cargo install` and runs in one command, perfect for rust github actions workflows or rust github ci pipelines. Early adopters love the stability—no judgment calls, just honest text preservation for agent reading.

Who should use this?

AI engineers building book-reading agents or RAG systems over novels and docs. Teams processing EPUB corpora for LLMs, especially in rust github trending projects needing rust cli tools for data prep. Rust devs scripting rust github api integrations or rust clippy-checked pipelines for book-to-markdown conversion.

Verdict

Grab it if you need EPUBs bot-ready—solid tests, MIT license, and example outputs make it production-viable despite 14 stars and 1.0% credibility score. Still early; watch for broader EPUB quirks as it matures.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.