Reading the repo
Reading the repo
How to install on macOS
An AI skill that turns books into animated, narrated, interactive web experiences
Saved setup from 3 h ago
Will it work on macOS?
Install the Skill in your project, for Claude Code or OpenCode:
npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code # or --agent opencode
Then type /papermorph. It finds the PDF in your project (or asks for your story), tells you what kind of book it is, suggests a chapter to try first and how much animation it needs, and offers a recommended option at every step. Your choices are saved in style.json, so every later chapter is made to the same style.
In OpenCode, a clone of this repository already has the command (.opencode/commands/papermorph.md) and the Skill; with a global install, copy that file to ~/.config/opencode/commands/.
You need uv, ffmpeg, and Playwright's browsers (uv run --with playwright playwright install chromium firefox). Narration uses Edge TTS (online) or Kokoro (local), free. A few steps are paid, optional and need an API key: acted ElevenLabs voices for picture books and documentaries, clips made from a still (OpenRouter), and painted sets for picture books (OpenRouter or OpenAI). The newest picture books cost under $0.45 each in voices.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/DozenTwelve/Papermorph.git cd Papermorph
Node.js
brew install node
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code # or --agent opencode
No reports for macOS yet.
Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.