{"full_name":"HKUDS/DeepTutor","owner":"HKUDS","name":"DeepTutor","url":"https://github.com/HKUDS/DeepTutor","description":"DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.","homepage":"http://arxiv.org/abs/2604.26962","topics":[],"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-07T15:18:10Z","metrics":{"stars":57786,"forks":7042,"watchers":236,"issues":877,"prs":1587,"releases":90,"issues_open":null,"issues_closed":null,"prs_open":null,"prs_closed":null,"prs_merged":null,"discussions":38},"growth":{"day":{"stars":475,"forks":48,"base_day":"2026-11-09"},"week":{"stars":3546,"forks":405,"base_day":"2026-11-03"},"month":{"stars":16965,"forks":1888,"base_day":"2026-10-11"}},"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"],"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],"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],"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],"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],"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]},"boards":{"daily":77,"weekly":33,"monthly":28,"weekly_rate":61,"monthly_rate":65},"same_owner":[{"full_name":"HKUDS/AI-Researcher","name":"AI-Researcher","boards":{}},{"full_name":"HKUDS/AI-Trader","name":"AI-Trader","boards":{}},{"full_name":"HKUDS/AutoAgent","name":"AutoAgent","boards":{}},{"full_name":"HKUDS/CLI-Anything","name":"CLI-Anything","boards":{"monthly":80,"monthly_rate":123}},{"full_name":"HKUDS/ClawTeam","name":"ClawTeam","boards":{}},{"full_name":"HKUDS/DeepCode","name":"DeepCode","boards":{}},{"full_name":"HKUDS/LightRAG","name":"LightRAG","boards":{}},{"full_name":"HKUDS/OpenHarness","name":"OpenHarness","boards":{}},{"full_name":"HKUDS/Vibe-Trading","name":"Vibe-Trading","boards":{"weekly":198,"monthly":162,"monthly_rate":157}},{"full_name":"HKUDS/nanobot","name":"nanobot","boards":{}}],"issues":[{"number":78,"title":"DeepTutor微信交流群","comments":22,"created_at":"2026-01-08T12:28:06Z"},{"number":431,"title":"[Question]:Cannot process scanned PDF in Knowledge Base - \"Skipped empty document\" error","comments":10,"created_at":"2026-05-01T03:10:18Z"},{"number":902,"title":"feat(knowledge): add durable web-source sync follow-ups","comments":8,"created_at":"2026-08-17T15:36:04Z"},{"number":498,"title":"DeepTutor Roadmap","comments":7,"created_at":"2026-05-20T16:47:57Z"},{"number":451,"title":"[Feature Request]:如何禁用周期性的 LLM 健康检查以避免消耗 token？","comments":7,"created_at":"2026-05-06T09:27:52Z"},{"number":2330,"title":"[Bug]: In-app updater upgrades only core, so a 1.6.x → 1.7.x update leaves all modules uninstalled and DeepTutor fails to restart","comments":6,"created_at":"2026-11-02T02:00:28Z"},{"number":1228,"title":"Learner accounts get 403 on /api/courses — and the UI masks it as an empty state","comments":6,"created_at":"2026-09-04T11:14:52Z"},{"number":745,"title":"[Bug]: GraphRAG request configuration diverges from DeepTutor chat and embedding profiles","comments":6,"created_at":"2026-08-01T15:07:18Z"}],"discussions":[{"number":2497,"title":"Ask for Help","comments":1,"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":8,"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"},{"number":1960,"title":"Will we got desktop version in the future?","comments":1,"category":"Q&A","created_at":"2026-10-14T08:03:21Z"},{"number":1913,"title":"It Made Itself the Curriculum","comments":0,"category":"General","created_at":"2026-10-10T08:54:48Z"},{"number":1905,"title":"How to configure OpenCode when running `deeptutor init`?","comments":2,"category":"Q&A","created_at":"2026-10-09T08:12:14Z"},{"number":1658,"title":"Architecture: trusted learning progress versus reward plugins","comments":0,"category":"Ideas","created_at":"2026-09-29T14:28:07Z"}],"latest_release":{"name":"v1.7.2","tag":"v1.7.2","published_at":"2026-11-06T08:42:06Z","body":"# DeepTutor v1.7.2 Release Notes\n\n**Release Date:** 2026.11.06\n\nBuilding on [v1.7.1](ver1-7-1.md), v1.7.2 adds selected-text read-aloud, easier model setup, and more reliable guided learning, retrieval, and updates. Desktop releases now require Apple Silicon and Intel Mac installers alongside both Windows downloads.\n\n## What's New\n\n### Complete desktop downloads and sturdier Windows support\n\nGitHub Releases provide Apple Silicon and Intel DMGs, a Windows installer, and a Windows portable ZIP. The release workflow checks every platform and all versioned downloads and stable aliases. Windows fixes cover session and migration locks, plugin environments, Python executable discovery, non-UTF-8 output, and paths containing spaces.\n\n### Read just the passage you need\n\nSelect text in Chat, Mastery Path, or Reading and choose **Read aloud** to hear it through your configured speech provider. Chat read-aloud also remembers playback speed per conversation in the current browser. Voice rendering handles escaped percent signs and degree notation more naturally, and Video Lesson's Edge fallback selects a voice matching the lesson language.\n\n### Easier provider setup and broader compatibility\n\nSettings discovers available models after credential edits and lets you import several at once. New custom providers default to automatic protocol selection. NVIDIA NIM adds text retrieval embeddings with distinct query and passage roles; newer DashScope image models use their matching generation protocol, with 4K restricted to `wan2.7-image-pro`. Responses API tool arguments, structured output, replayed history, and Codex custom headers receive compatibility fixes.\n\n### Guided learning that keeps the context\n\nChoose a model before a Mastery Path outline starts. Follow-up clarifications and missing parts are assessed with the explanation they complete, while stale card replies and duplicate retries are handled more carefully. Source quotation mismatches receive a bounded retry, and mastery navigation, board scrolling, and tutoring-memory recovery are more reliable.\n\n### More accessible conversations and retrieval\n\nKorean is available as a **partial** interface translation, with English fallback for untranslated text. More labels and dates follow the selected interface language. Little Tutor threads appear in the command palette, document readers load on demand, and socket failures and cancellation recover more predictably. BM25 preserves dotted identifiers, document extraction stays off the API event loop, and notebook and favorite tools support read-only record retrieval.\n\n### Safer updates and bounded reasoning recovery\n\nPackage updates keep installed feature modules on the target core version and record launch failures instead of remaining stuck at restart. Detached launches avoid stale source-tree imports, and failed CLI-app rollbacks preserve backups. The shared agent loop can stop or make one explicitly bounded higher-budget retry when reasoning exhausts the output budget without a visible answer.\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.2\"`. Keep the same `DEEPTUTOR_HOME`; verify with `python -m pip check` and `deeptutor module list` before restarting. Any additional feature wheels must also match version 1.7.2.\n- **Legacy installations:** upgrades from 1.6.15 or earlier must uninstall the legacy `deeptutor-cli` package before installing the modular package family. Follow the migration commands in [v1.7.0](past_releases/ver1-7-0.md).\n- **Source installs:** install `requirements/full.txt`, then `python -m pip install -e . --no-deps`. Stop active servers and CLI turns before changing modules.\n- **Docker:** pull `ghcr.io/hkuds/deeptutor:1.7.2` or `:latest` and recreate the container with the existing data volume.\n- **Desktop:** use the matching installer or portable ZIP on this GitHub Release. Windows builds remain unsigned. Automatic desktop upda"},"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":"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-10T09:35:25Z","history_start":"2026-09-06"}