[{"_1":2,"_162":-5,"_163":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_140":141},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_131":-5,"_132":11,"_133":17,"_134":11,"_135":-5,"_136":11,"_137":-5,"_138":139},"canonicalUrl","https://hub.docker.com/r/drumsergio/askepub/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","drumsergio","reponame","askepub","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2026-03-27T09:49:39.142717Z","description","","is_private","last_updated","2026-06-07T20:48:37.783136Z","last_modified","2026-04-11T13:36:18.660775Z","media_types",[52],"application/vnd.oci.image.index.v1+json","name","pull_count",1308,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

$\"AskePub$

\n\n

$\"AskePub$

\n\n

AskePub

\n\n

\n $\"License\"$ \n $\"codecov\"$ \n

\n\n

Telegram bot assistant to help you prepare ePubs. Uses ChatGPT-4o to write contextual notes.

\n\n---\n\n## Features\n\n- Upload any `.epub` file via Telegram\n- Select specific chapters or study the entire book\n- Customize up to 10 study questions (or use smart defaults)\n- Get three output formats:\n - **Annotated ePub** with study notes injected into each chapter\n - **Word document** (.docx) with all notes organized by chapter\n - **PDF** with the same content\n- Multi-language support (English, Spanish, Italian, French, German, Portuguese, Bulgarian)\n- User access control via whitelist\n- Rate limiting to manage API costs\n- Admin notification and broadcast system\n\n## Install\n\n### Docker (recommended)\n\n```sh\ndocker run --name askepub \\\n -e TOKEN=your-telegram-bot-token \\\n -e OPENAI_API_KEY=your-openai-key \\\n -e ADMIN_ID=your-telegram-user-id \\\n -e USER_IDS=id1,id2,id3 \\\n -v askepub-dbs:/app/dbs \\\n -v askepub-backups:/app/userBackups \\\n drumsergio/askepub:2.0.0\n```\n\n### Docker Compose\n\n```sh\ndocker compose up -d\n```\n\nSee [`docker-compose.yml`](docker-compose.yml) for the full configuration.\n\n### Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `TOKEN` | Yes | Telegram bot token from @BotFather |\n| `OPENAI_API_KEY` | Yes | OpenAI API key |\n| `ADMIN_ID` | Yes | Telegram user ID of the bot admin |\n| `TOKEN_NOTIFY` | No | Secondary bot token for admin notifications |\n| `USER_IDS` | No | Comma-separated Telegram user IDs allowed to use the bot |\n\n## Usage\n\n1. Start a chat with your bot on Telegram\n2. Send `/start`\n3. Select your language\n4. Upload an `.epub` file\n5. Choose which chapters to study\n6. Customize your study questions (or use defaults)\n7. Wait for the AI to generate notes\n8. Download your annotated ePub, DOCX, and PDF\n\n### Commands\n\n- `/start` - Start the bot and begin a study session\n- `/change_language` - Change your interface language\n- `/cancel` - Cancel the current operation\n\n## Maintainers\n\n[@GeiserX](https://github.com/GeiserX)\n\n## Contributing\n\nFeel free to dive in! [Open an issue](https://github.com/GeiserX/askepub/issues/new) or submit PRs.\n\nAskePub follows the [Contributor Covenant](http://contributor-covenant.org/version/2/1/) Code of Conduct.\n\n## Related Projects\n\n**ePub Tools:**\n\n- [ePubLangMerger](https://github.com/GeiserX/ePubLangMerger) — Merge two ePubs into a bilingual parallel reading book\n- [epub-and-vtt-to-llm](https://github.com/GeiserX/epub-and-vtt-to-llm) — Fine-tune LLMs from ePub and subtitle data\n\n**Telegram Bots:**\n\n- [Telegram-Archive](https://github.com/GeiserX/Telegram-Archive) — Automated Telegram backup with local web viewer\n- [paperless-telegram-bot](https://github.com/GeiserX/paperless-telegram-bot) — Manage Paperless-NGX documents through Telegram\n- [telegram-delay-channel-cloner](https://github.com/GeiserX/telegram-delay-channel-cloner) — Relay messages between channels with delay\n- [jellyfin-telegram-channel-sync](https://github.com/GeiserX/jellyfin-telegram-channel-sync) — Sync Jellyfin access with Telegram membership\n- [telegram-slskd-local-bot](https://github.com/GeiserX/telegram-slskd-local-bot) — Automated music discovery and download via Telegram\n\n## License\n\n[MIT](LICENSE)\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",1991724579,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":120,"_121":90,"_122":29,"_123":52,"_53":124,"_125":126,"_127":105,"_128":120,"_129":62,"_130":17},"content_type","creator",870817,"digest","sha256:b67d3bb393cc06e81a5bc45b03652b5f163b0359e9a04405660cd87850b1b0d6","full_size",355048846,"id",1113667816,"images",[99,114],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},"architecture","amd64","sha256:60b746a3ac36bed7bbcde8fea976166fb05e0df2fe18d9d696bb1f42e5f9ae9a","features","last_pulled","2026-09-21T15:18:08.861972686Z","last_pushed","2026-06-07T20:48:34.27495983Z","os","linux","os_features","os_version","size","variant",{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},"unknown","sha256:d6854a23b165fb3ef6047d7af9c13980371e0827f5beb8790df236fa56d3c3af","2026-09-21T13:46:40.619198733Z","2026-06-07T20:48:35.378790544Z",25287,"2026-06-07T20:48:36.45654Z","last_updater","last_updater_username","media_type","latest","repository",30573652,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":142,"_149":150,"_138":160,"_161":11},{"_36":143,"_38":144,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":145,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":146,"_75":11,"_76":148,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":147},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_151":60,"_152":-5,"_153":-5,"_154":155},"count","next","previous","results",[156],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":157,"_46":120,"_121":90,"_122":29,"_123":52,"_53":124,"_125":126,"_127":105,"_128":120,"_129":62,"_130":17},[158,159],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

drumsergio/askepub

Tags for drumsergio/askepub