An AI skill that turns books into animated, narrated, interactive web experiences
JavaScript ai-agentsai-educationanimationclaudeclaude-codeclaude-skillsedtecheducationinteractive-textbookscormtext-to-video
docs: add visual README and getting started
yzr4a2efa06ab45
diff --git a/.gitignore b/.gitignoreindex ebcf1e8..4268a3e 100644--- a/.gitignore+++ b/.gitignore@@ -15,7 +15,13 @@ books/*/pages//plan.md/sections.json/3.png-/img/+/img/*+!/img/readme/+/img/readme/*+!/img/readme/logo.png+!/img/readme/logo_light.png+!/img/readme/papermorph-preview.gif+!/img/readme/papermorph-preview.mp4/scripts//books//content/diff --git a/README.md b/README.mdindex a87066d..19ce477 100644--- a/README.md+++ b/README.md@@ -1,44 +1,54 @@-# Papermorph--An AI skill that turns books into animated, narrated, interactive web experiences.--[Live bookshelf](https://math.diamonddoge.org/) · [MIT License](LICENSE)--## The Skill--The core of Papermorph is a reusable book-making Skill: [.claude/skills/papermorph/SKILL.md](.claude/skills/papermorph/SKILL.md).--It guides an AI agent through reference preparation, book planning, storyboards, narration, animated chapters, and interactive exercises. It includes production scripts, lesson engines, and templates. Start with `SKILL.md`, then read the references needed for the current stage.--Production tools use `uv`, PDF extraction, Edge TTS, and Playwright as described in the Skill. Generated books run as static websites without a backend or live AI calls.--## Example books--The website in `site/` showcases:--- **Elementary Algebra**: 68 animated, narrated chapters.-- **Elementary Mathematics**: three available chapters, with further production currently paused.+<p align="center">+ <picture>+ <source media="(prefers-color-scheme: dark)" srcset="img/readme/logo_light.png">+ <source media="(prefers-color-scheme: light)" srcset="img/readme/logo.png">+ <img src="img/readme/logo.png" alt="Papermorph" width="600">+ </picture>+</p>++<p align="center">+ <strong>A Skill that turns PDFs into animated interactive web books.</strong>+</p>++You've seen Opus 5.5 one-shot videos. This Skill takes it further: books you can explore, listen to, and interact with.++<p align="center">+ <a href="https://papermorph.diamonddoge.org/">Explore the live bookshelf →</a>+ ·+ <a href=".claude/skills/papermorph/SKILL.md">Use the Skill</a>+</p>++<p align="center">+ <a href="img/readme/papermorph-preview.mp4">+ <img src="img/readme/papermorph-preview.gif" alt="Real demo: bookshelf, animated lessons, and interactive quizzes" width="900">+ </a>+ <br>+ <a href="img/readme/papermorph-preview.mp4">Watch the full 75-second demo with narration</a>+</p>++```text+PDF -> Book plan -> Storyboards -> Narration -> Animation & quizzes -> Web book+```-The bookshelf is the project's showcase. Its appearance will continue to evolve as more books are added.+## Get started-The book cover pages credit their reference textbooks and link to the publishers. Reference PDFs, extracted source pages, private production notes, narration drafts, and unused artwork remain local and are not tracked in this repository. The bookshelf image used by the live website is included.+```bash+git clone https://github.com/DozenTwelve/Papermorph.git+cd Papermorph+```-## Preview+Open the repository in your coding agent with Opus 5.5, then send:-There is no build step. Serve the website over HTTP for audio playback:+```text+Follow .claude/skills/papermorph/SKILL.md to turn+/path/to/book.pdf into an animated interactive web book.-```sh-python3 -m http.server 8765 -d site+Target readers: [your audience].+Start with one English chapter for review.```-Open `http://localhost:8765/`.+**Today:** Opus 5.5 only. No image models, multilingual support, or BGM yet.-## Deploy--The current website uses Cloudflare Pages project `animebook`, production branch `main`, and domain `math.diamonddoge.org`. Deploy only `site/`:--```sh-npx wrangler pages deploy site --project-name animebook --branch main-```+**Planned:** Image models and storyboarding for interactive picture books and humanities documentaries.-Maintain public repository documentation in English.+[MIT License](LICENSE)diff --git a/img/readme/logo.png b/img/readme/logo.pngnew file mode 100644index 0000000..e5ef67aBinary files /dev/null and b/img/readme/logo.png differdiff --git a/img/readme/logo_light.png b/img/readme/logo_light.pngnew file mode 100644index 0000000..949b797Binary files /dev/null and b/img/readme/logo_light.png differdiff --git a/img/readme/papermorph-preview.gif b/img/readme/papermorph-preview.gifnew file mode 100644index 0000000..cdf0450Binary files /dev/null and b/img/readme/papermorph-preview.gif differdiff --git a/img/readme/papermorph-preview.mp4 b/img/readme/papermorph-preview.mp4new file mode 100644index 0000000..de51020Binary files /dev/null and b/img/readme/papermorph-preview.mp4 differ