{"full_name":"HKUDS/DeepTutor","owner":"HKUDS","name":"DeepTutor","shard":"1","url":"https://github.com/HKUDS/DeepTutor","description":"DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.","homepage":"http://arxiv.org/abs/2604.26962","topics":["ai-tutor","deepresearch","interactive-learning","multi-agent-systems","rag","ai-agents","cli-tool","clawbot","learning"],"tag_pages":["ai-agents","cli-tool","learning","multi-agent-systems","rag"],"language":"Python","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/118165258?v=4","created_at":"2025-12-28T15:35:54Z","pushed_at":"2026-11-15T18:18:05Z","metrics":{"stars":59451,"forks":7201,"watchers":234,"issues":933,"prs":1714,"releases":91,"issues_open":123,"issues_closed":810,"prs_open":162,"prs_closed":405,"prs_merged":1147,"discussions":42},"growth":{"day":{"stars":269,"forks":27,"base_day":"2026-11-15"},"week":{"stars":2140,"forks":207,"base_day":"2026-11-09"},"month":{"stars":18241,"forks":2003,"base_day":"2026-10-17"}},"history":{"dates":["2026-10-06","2026-10-07","2026-10-08","2026-10-09","2026-10-10","2026-10-11","2026-10-12","2026-10-13","2026-10-14","2026-10-15","2026-10-16","2026-10-17","2026-10-18","2026-10-19","2026-10-20","2026-10-21","2026-10-22","2026-10-23","2026-10-24","2026-10-25","2026-10-26","2026-10-27","2026-10-28","2026-10-29","2026-10-30","2026-10-31","2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-09","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[40503,40504,40616,40683,40748,40821,40851,40892,40947,41023,41092,41210,41295,41392,41450,41509,41568,41764,41893,42017,42160,42280,42519,43639,45614,47758,49669,51623,54240,54677,57311,57786,58236,58549,58627,58921,59182,59451],"forks":[5115,5115,5137,5140,5149,5154,5162,5166,5173,5177,5186,5198,5203,5214,5227,5238,5243,5281,5302,5324,5349,5370,5393,5506,5733,5933,6121,6320,6637,6687,6994,7042,7079,7113,7126,7151,7174,7201],"watchers":[191,191,190,190,192,193,192,192,192,193,194,193,193,192,192,192,192,194,195,195,195,195,191,193,202,212,216,222,229,232,236,236,236,238,237,237,236,234],"issues_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,197,205,206,208,118,123],"prs_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,219,223,233,255,268,162]},"boards":{"daily":87,"weekly":66,"monthly":24,"monthly_rate":79,"daily_forks":190},"same_owner":[{"full_name":"HKUDS/AI-Researcher","name":"AI-Researcher","shard":"1","boards":{}},{"full_name":"HKUDS/AI-Trader","name":"AI-Trader","shard":"1","boards":{}},{"full_name":"HKUDS/AutoAgent","name":"AutoAgent","shard":"1","boards":{}},{"full_name":"HKUDS/AutoSwarm","name":"AutoSwarm","shard":"1","boards":{}},{"full_name":"HKUDS/CLI-Anything","name":"CLI-Anything","shard":"1","boards":{"monthly":87}},{"full_name":"HKUDS/ClawTeam","name":"ClawTeam","shard":"1","boards":{}},{"full_name":"HKUDS/DeepCode","name":"DeepCode","shard":"1","boards":{}},{"full_name":"HKUDS/LightRAG","name":"LightRAG","shard":"1","boards":{}},{"full_name":"HKUDS/OpenHarness","name":"OpenHarness","shard":"1","boards":{}},{"full_name":"HKUDS/Vibe-Trading","name":"Vibe-Trading","shard":"1","boards":{"daily":188,"monthly":185,"daily_watchers":78}},{"full_name":"HKUDS/nanobot","name":"nanobot","shard":"1","boards":{}}],"issues":[{"number":78,"title":"DeepTutor微信交流群","comments":24,"created_at":"2026-01-08T12:28:06Z"},{"number":431,"title":"[Question]:Cannot process scanned PDF in Knowledge Base - \"Skipped empty document\" error","comments":11,"created_at":"2026-05-01T03:10:18Z"},{"number":902,"title":"feat(knowledge): add durable web-source sync follow-ups","comments":9,"created_at":"2026-08-17T15:36:04Z"},{"number":498,"title":"DeepTutor Roadmap","comments":8,"created_at":"2026-05-20T16:47:57Z"},{"number":1228,"title":"Learner accounts get 403 on /api/courses — and the UI masks it as an empty state","comments":7,"created_at":"2026-09-04T11:14:52Z"},{"number":451,"title":"[Feature Request]:如何禁用周期性的 LLM 健康检查以避免消耗 token？","comments":7,"created_at":"2026-05-06T09:27:52Z"},{"number":745,"title":"[Bug]: GraphRAG request configuration diverges from DeepTutor chat and embedding profiles","comments":6,"created_at":"2026-08-01T15:07:18Z"},{"number":375,"title":"[Feature Request]:References带出的内容需要做合规过滤","comments":6,"created_at":"2026-04-24T01:45:44Z"}],"discussions":[{"number":2661,"title":"Chopper: a small open model that cuts only the needed sentences out of retrieved text","comments":0,"category":"Show and tell","created_at":"2026-11-13T09:12:23Z"},{"number":2634,"title":"Help","comments":1,"category":"Q&A","created_at":"2026-11-11T23:29:56Z"},{"number":2623,"title":"配置自定义Adapter及模型ID测试报异常","comments":2,"category":"Q&A","created_at":"2026-11-11T08:49:15Z"},{"number":2611,"title":"Asking for Help","comments":2,"category":"Q&A","created_at":"2026-11-11T00:54:03Z"},{"number":2497,"title":"Ask for Help","comments":2,"category":"Q&A","created_at":"2026-11-06T13:38:20Z"},{"number":2369,"title":"When running on Windows \"Open DeepTutor\" does not work.","comments":0,"category":"General","created_at":"2026-11-02T11:27:58Z"},{"number":2217,"title":"Community pre-validation batch — 43 PRs checked; 35 merged (Oct 31)","comments":11,"category":"General","created_at":"2026-10-30T19:58:46Z"},{"number":1981,"title":"Anki Card","comments":0,"category":"General","created_at":"2026-10-17T05:34:22Z"}],"latest_release":{"name":"v1.7.3","tag":"v1.7.3","published_at":"2026-11-15T18:18:06Z","body":"# DeepTutor v1.7.3 Release Notes\n\n**Release Date:** 2026.11.16\n\nBuilding on [v1.7.2](past_releases/ver1-7-2.md), v1.7.3 makes reading and book editing more flexible, expands search and agent connections, and improves learning records, model streams, and desktop upgrades.\n\n## What's New\n\n### Read, zoom, and revisit question help\n\nThe PDF reader adds continuous zoom, text-fit controls, and an image viewer. Annotation updates and multi-material selection are more reliable. Reading quizzes keep answer keys on the server and preserve question-linked help separately from attempts; authorized guardians can review reading progress, quiz records, and help activity.\n\n### Review book changes before applying them\n\nEdit generated chapters and sections without rebuilding the whole book. Structure changes and page-chat proposals show a reviewable diff before application, and the most recent unchanged edit can be undone. New empty sections generate when opened; math rendering and page-chat continuation also receive fixes.\n\n### More search providers and connected agents\n\nSearch adds DeepSeek, SpecStream, and SearchApi, including SearchApi web, news, and scholar modes. Web Fetch gains a selectable DeepSeek backend, and Standard Compute joins model setup. A configured Agent Client Protocol (ACP) process can be consulted as a local subagent. MCP OAuth refresh and reconnection are more reliable after consent and restarts.\n\n### Conversations and practice retain their context\n\nChoose supported reasoning effort per conversation. Untouched chat sessions inherit ready workspace knowledge bases, saved side-chat tabs reopen for the same account, and question-bank sources support search and pagination. Mastery fixes preserve explanations across failed attempts, keep issued questions gradable after re-indexing, and improve reference answers and narrow-screen navigation.\n\n### Better document parsing and language support\n\nDocling preserves structured page content and exposes optional formula and picture enrichments. Upload validation follows the available parser formats, GitHub knowledge sources accept MDX, and retrieval respects exact source paths. Italian and Hungarian join the interface and reply-language options, while Hindi becomes a reply language.\n\n### More reliable model streams and desktop upgrades\n\nProvider calls handle stalled streams, incomplete terminal events, tool identifiers, and replayed reasoning more carefully. History that still exceeds its plan after condensation stops with a clear error. Installing a newer desktop app adopts its newer bundled core with backup and rollback; macOS Finder launches also discover host CLIs in common install locations. Launcher and updater readiness waits respect configured limits.\n\n## Upgrade Notes\n\n- **Full app:** stop DeepTutor and back up the runtime home, then run `python -m pip install --upgrade \"deeptutor[full]==1.7.3\"`. Keep the same `DEEPTUTOR_HOME`; verify with `python -m pip check` and `deeptutor module list` before restarting. Additional feature wheels must also match 1.7.3.\n- **Legacy installations:** versions 1.6.15 and earlier require uninstalling the old `deeptutor-cli` package before installing the modular family. Use the manual migration in [v1.7.0](past_releases/ver1-7-0.md); an old update worker cannot acquire the new migration logic retroactively. Recover a full app with optional parsing using `\"deeptutor[full,parse]==1.7.3\"` in the same environment.\n- **Source and Docker:** source users install `requirements/full.txt`, then `python -m pip install -e . --no-deps`, and refresh `web/` with `npm ci --legacy-peer-deps` on Node.js 22. Docker users pull `ghcr.io/hkuds/deeptutor:1.7.3` or `:latest` and recreate the container with its existing data volume.\n- **Desktop:** use the matching Apple Silicon or Intel DMG, Windows installer, or portable ZIP. Windows builds remain unsigned. Automatic update discovery is not connected; replacing the app now trials a newer bundled core and preserves a works","is_prerelease":false},"readme":true,"readme_zh":false,"news":[{"title":"DeepTutor: Agent-Native Personalized Tutoring","url":"https://github.com/HKUDS/DeepTutor","hn":"https://news.ycombinator.com/item?id=47703911","source":"Hacker News","lang":"en","date":"2026-04-09","points":2,"comments":0},{"title":"The week where skills to reduce AI-likeness took 1st place | Weekly GitHub Trends #1 (10/25–10/31)","url":"https://note.com/bochibochi_ai/n/n9fcd2ac3e3c0?hl=en","source":"note","lang":"en","date":"2026-11-02"},{"title":"Jakub Slys on X: \"DeepTutor's two-layer plugin model matters more than the tutor persona.\"","url":"https://x.com/jakub_slys/status/2116973804983603286","source":"x","lang":"en","date":"2026-11-01"},{"title":"Top 5 Trending AI/ML OSS on GitHub [As of October 30, 2026]","url":"https://note.com/safe_salvia2024/n/n0eb253baae53?hl=en","source":"note","lang":"en","date":"2026-10-30"},{"title":"DeepTutor 部署教程：5 分钟搭好带知识库与长期记忆的 AI 学习助手","url":"https://blog.csdn.net/gitblog_01120/article/details/166894641","source":"blog.csdn","lang":"zh","date":"2026-10-29"},{"title":"DeepTutor AI 辅导工作台：知识库到互动教材的 4 个真实场景","url":"https://blog.csdn.net/gitblog_00305/article/details/155374875","source":"blog.csdn","lang":"zh","date":"2026-08-31"},{"title":"HKUDS DeepTutor Is Trending, but Its Real Test Starts After the GitHub Rush","url":"https://www.remio.ai/post/hkuds-deeptutor-is-trending-but-its-real-test-starts-after-the-github-rush","source":"remio.ai","lang":"en","date":"2026-08-11"},{"title":"在线教程丨港大团队开源个人学习助手DeepTutor，多智能体协作实现覆盖理解/推理/生成的交互式学习","url":"https://news.qq.com/rain/a/20260414A043M700","source":"腾讯网","lang":"zh","date":"2026-04-14"},{"title":"港大 DeepTutor 開源登場 將 PDF 教材轉化為互動個人化教學 變身 AI 個人補習老師","url":"https://unwire.hk/2026/04/10/deeptutor-hku-open-source-ai-tutor/software/","source":"香港unwire.hk 玩生活．樂科技","lang":"zh","date":"2026-04-09"},{"title":"香港大学推出AI学习助手DeepTutor：解锁学习新方式的秘密武器","url":"https://www.sohu.com/a/974604015_121956424","source":"搜狐","lang":"zh","date":"2026-01-10"},{"title":"5 GitHub Finds That Exploded This Week (Free Tutor, NotebookLM Clone & More) #Shorts","url":"https://news.google.com/rss/articles/CBMiQkFVX3lxTE9sV3VuZk1WcGtRSTJyeEU0bmtDSW5zUE43SFRna04ySEkyQkx3RFFRenNjSHcyMlhUejVKRVdiaWpqQQ?oc=5","source":"YouTube","lang":"en","date":"2026-10-30"},{"title":"早报｜曝苹果折叠屏iPhone已在量产/DeepSeek或自研AI推理芯片/今年618手机销量同比下滑13%","url":"https://news.google.com/rss/articles/CBMiQ0FVX3lxTFBZcm1KOUJvb3gxSUJwcF8wZnlCeTA4X3pocTFIaWxhazc1RWlhT2pIVGdjV0pjZjk0ME9fbWFSVDJuQ1E?oc=5","source":"爱范儿","lang":"zh","date":"2026-07-08"},{"title":"DeepTutor: A useful AI-powered personalized learning assistant","url":"https://news.google.com/rss/articles/CBMiU0FVX3lxTE5rQkl4LTV6aUlrSzMyNFkzSEZhWkp2RlNsamFjZ1hROWFXYTJaMWs3ZUZreW1nZUJtNVJuOElkTk5fbVhTQWJyMjRfVXZmdTRFbHhF?oc=5","source":"Desde Linux","lang":"en","date":"2026-01-05"}],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}