Drop in a PDF or EPUB. Pip turns every chapter into a five-step loop that actually makes it stick.
_{Podcasts · explainer videos · reading plans · recall checks · quizzes · mind maps · concept graphs · flashcards}

_{🐾 a little tour: drop a book → Pip prepares it → listen · read · recall · map · remember → watch your book map grow}

🌸 How a loop works

Every chapter is one loop. Chapters open one at a time, so you really finish what you start.

1 · Listen & watch	A two-host podcast about the chapter and a short animated explainer. Hearing the ideas first makes the page feel familiar.
2 · Read	The chapter itself, like a textbook (figures, captions, lists), with a reading plan that says what to read closely and what to skim.
3 · Recall	Explain it in your own words; a small model checks each key point. Then a quiz with hints and explanations.
4 · Map	Remake the mind map from memory, then explore the concept graph: guided tour, "how are these connected?", rebuild from memory.
5 · Remember	Flashcards on a spaced-repetition schedule (FSRS) that bring each card back right before you'd forget it.

Close a loop and the next chapter opens 🎉. Your book map sprouts with every chapter you map, and Your year with Pip fills in a little square for every day you study.

✨ What makes it lovely

🧠 Your AI, your choice Google NotebookLM by default. Or Claude, OpenAI, OpenRouter, a free local model (Ollama, LM Studio, any OpenAI-compatible server), opencode, or Hermes. If one can't make something, another steps in, and the book always finishes.	🔒 Private by design Your books stay on your Mac. Only the chapter being prepared goes to the AI you chose, and your library syncs only to a hidden app folder in your own Google Drive.	💻 Mac + iPad The Mac prepares books; the iPad picks up your library, progress, cards, and where you left off. Study offline once a chapter is open.
🐾 Pip in your menu bar Pick up where you left off, play the podcast, see what's ready, and get at most one gentle nudge a day (never in quiet hours, never guilt).	🎧 Voices on your Mac Podcasts and explainers are voiced on-device with Rumik, with a "fast" mode, and podcast length that fits the chapter.	📦 Install once One download with the programs inside: no Python, no Docker, no terminal. Rumik's voices and the local model download the first time your Mac's own AI is used.

🐼 Meet Pip

_{Pip reads with you, hops when you get it right, naps while it waits, and is never cross or disappointed. Stay away too long and Pip gets dramatic, just for laughs (a tiny sad violin 🎻, a sad song 😿, then a shocked “fahhh” after a whole day). Silly mode switches off in Settings.}

🚀 Get it

Mac (Apple silicon, macOS 14 or later)

1. Download the .dmg from the latest release.
2. Drag Pip into your Applications folder (the window shows you where 🐾).
3. Open NeuralLoop. The first time, macOS double-checks with you: System Settings → Privacy & Security → Open Anyway. After an update it may ask once to let NeuralLoop use its saved keys in your keychain: enter your password and click Always Allow (why).
4. Sign in with Google when Pip asks: NotebookLM makes your podcasts and videos with that account, and your library follows you to the iPad through it. Not now is fine too; Pip then uses your Mac's own AI, or the one you pick in Settings → Your AI.

iPad (iPadOS 17 or later)

For now, the iPad app is built from this repo with Xcode (free Apple ID is fine). The steps are in docs/DEVELOPMENT.md → Installing on your iPad.

Build from source

make setup    # once: a .venv with hash-locked tools
make check    # every test and linter
make mac      # build and open the Mac app

docs/ARCHITECTURE.md is a guided tour of the code, and CLAUDE.md has the rules and contracts. Contributions are welcome: see CONTRIBUTING.md.

📜 Licensing

NeuralLoop is source-available under the PolyForm Noncommercial License 1.0.0.

✅	Free for personal use, learning, research, teaching, and other non-commercial purposes
❌	Not for commercial use, resale, or offering it as a paid product or service without a commercial license

The NeuralLoop name and Pip are brand assets, not covered by the software license (TRADEMARKS.md). Third-party parts keep their own licenses (NOTICE.md); the Rumik voices are non-commercial.

Commercial licensing and partnerships: open an issue titled "Commercial license", or reach out through github.com/NebulaTris. Security reports: please use GitHub's private vulnerability reporting (SECURITY.md).

_{Made with care (and a lot of yarn) · Learn it. Loop it. 🐾}