yuxino/satori
A macOS app that explains any part of a PDF textbook the moment you select it
satori is a macOS reader for PDF textbooks that lets you select a confusing paragraph, figure, or code block and get an explanation based on that page. It works on both text-native and scanned PDFs, and your books plus reading history stay on your Mac. Only the explanation itself is generated on demand by an external AI model, Alibaba Cloud's Qwen.
What it does
- Selecting a paragraph, figure, or code block on a PDF page triggers an AI-generated explanation based on that page's content.
- Works on both text-native PDFs and scanned (image-based) PDFs.
- Includes reader features like continuous scrolling, pinch-to-zoom, page thumbnails, and jump-to-page by number.
- You can switch between multiple books, and both reading position and past Q&A history are saved locally on your Mac.
- Runs on macOS 14 or later via npm install and npx tauri dev, and is released under the MIT license.
Why it matters
Instead of switching tabs to search or copy-pasting confusing passages into a separate chatbot, readers can ask questions right where they're reading and get answers tied to that exact page. Because books and history stay local and only the explanation call goes out to an AI service, it suits people who want AI help with study materials without giving up control of their personal files.
Terms in this repo
- text-native PDF · a PDF made of actual selectable text rather than scanned images
- scanned PDF · a PDF created by scanning paper pages into images
- Tauri · a framework for wrapping web-based UIs into lightweight desktop apps
- Qwen · an AI language model provided by Alibaba Cloud
- Model Studio · Alibaba Cloud's service for calling AI models on demand
Repository description (English)
A local-first macOS workspace for understanding PDFs with AI
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install