brian901106 / japanese-tutor-mugi
倉鼠むぎ陪你一對一練日語會話的手機網頁 App。核心思想：讓 LLM 以 JSON Schema 輸出結構化回覆，日文台詞與中文小提醒分欄位，前端用部分 JSON 解析邊收邊顯示；長時間聊天也維持 prompt 快取與語音快取。漢字讀音由 LLM 標註，漏標的由伺服器端 kuromoji 補上。糾錯自動存成小提醒本，可以開口練到會。語音可選本機 VOICEVOX 或雲端 Google／Azure，金鑰只留在本機伺服器。以 Claude Code（Opus 5.5）協作開發，原為個人使用，以不含個人資料與第三方素材的全新 git 歷史開源發布，各項決策紀錄見 docs/decisions/。
A mobile web app where the hamster Mugi (むぎ) practices Japanese conversation with you one-on-one. Core idea: the LLM outputs structured replies using a JSON Schema, with the Japanese lines and the Chinese tips in separate fields, and the frontend uses partial JSON parsing to display the reply as it streams in; prompt caching and voice caching are maintained even during long chats. Kanji readings are annotated by the LLM, and any that it misses are filled in by kuromoji on the server side. Corrections are automatically saved into a tips notebook, so you can practice speaking until you have mastered them. For voice, you can choose local VOICEVOX or cloud Google/Azure, and the keys stay only on the local server. Developed in collaboration with Claude Code (Opus 5.5); originally for personal use, it was released as open source with a brand-new git history that contains no personal data or third-party assets. Records of each decision are in docs/decisions/. Machine translation by Claude Sonnet 5.5. A wrong translation? Report an error
Read the English README on GitHub (README.en.md, a file of the repository)
- Stars
- 104 stars
- Forks
- 35 forks
- Language
- TypeScript
- License
- MIT
- Created
- Oct 28, 2026
- Last push
- Nov 2, 2026
- Updated
- Nov 8, 2026
Why these Tags: an agent read the README and quoted it
- LLM chat interface from the readme:
這是一個適合手機使用的網頁 app，讓你和倉鼠 むぎ（Mugi）一對一練日語會話。むぎ 是由 Claude 驅動的可愛卡通倉鼠家教
(machine translation by Claude Sonnet 5.5:This is a mobile-friendly web app that lets you practice Japanese conversation one-on-one with the hamster むぎ (Mugi). むぎ is a cute cartoon hamster tutor powered by Claude
)
An agent gave these Tags from the fixed Tag list in the AwesomeRepos source code. A code check kept each Tag only when its quote is in the text. A wrong Tag? Report an error with the form at the end of this page.
Admitted to the Repository Index on Nov 7, 2026: +100 stars in 7 days.
Star History
8 days recorded, Nov 1, 2026 – Nov 8, 2026 (UTC). Net change +104 stars.
The star count of each day is the latest count minus the net stars of the later days.
Add this Star History to a README
The images follow the light or dark theme of the page that shows them, and update every hour.
Add ?theme=light or ?theme=dark
to the chart address to keep one theme.
Star History chart
[](https://awesomerepos.com/brian901106/japanese-tutor-mugi) Badge
[](https://awesomerepos.com/brian901106/japanese-tutor-mugi) Timeline
It gained stars on each of the 8 days recorded since Nov 1, 2026.
- Created on the Repository Host
- Largest star day recorded: +70 stars
- +19 stars in one day
- Latest push
- +4 stars in one day
- Reached 100 stars, 9 days after it was created
- Entered the Repository Index: +100 stars in 7 days
The timeline comes from the creation date and the releases on the Repository Host, the Admission, the Star History, and the Observations. Star milestones show only when the Star History records the day. The list shows up to 5 stable releases from the latest 10 releases recorded. When none of them is stable, one item counts the pre-releases. On the chart of net stars each day, a solid line marks each recorded release.
Forks and pushes
From 2 Observations, Nov 8, 2026 – Nov 9, 2026. Forks 0. AwesomeRepos saw a new push on 0 of 1 days.
- Nov 9, 2026: no new push
A filled day: the last push time changed since the Observation before it.
Health facts
Measured facts in four separate dimensions, each with a date and a source. AwesomeRepos does not add them into one score. AwesomeRepos last read these facts from GitHub on Nov 9, 2026. How AwesomeRepos defines each check
Maintenance
3 of 4 checks-
Yes: Not archived
GitHub does not mark the repository as archived. Source
-
Yes: A push in the last 90 days
Last push on 2026-11-02, 6 days ago. Source
-
Yes: Commits in the last 13 weeks
6 commits on the default branch in the last 13 weeks (GitHub, 2026-11-09). Source
-
No: Commits in 26 or more of the last 52 weeks
Commits in 2 of the last 52 weeks (GitHub, 2026-11-09). Source
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 2
- 4
Releases
0 of 3 checks (1 without data)-
No: A release in the last 365 days
No GitHub release (read on 2026-11-08). Source
-
No data: The newest release tag is a semantic version
No data: no release.
-
No: A changelog file at the root
No changelog file at the root (GitHub, 2026-11-09).
Security practice
0 of 1 check-
No: A security policy
GitHub finds no security policy (GitHub, 2026-11-09).
OpenSSF Scorecard has no result for this repository from the last 90 days.
Community files
1 of 3 checks-
Yes: A licence
GitHub finds the licence MIT. Source
-
No: A contributing guide
GitHub finds no contributing guide (GitHub, 2026-11-09).
-
No: A code of conduct
GitHub finds no code of conduct (GitHub, 2026-11-09).
Dependencies in the index
This section shows the packages that connect this repository to other repositories in the index.
GitHub has no dependency graph for this repository (scanned on Nov 9, 2026).
No scanned repository names a package from this repository.
Uses (in the index) · 0
None.
Used by (in the index) · 0
None.
Sources: the GitHub dependency graph of each repository, and deps.dev for the source repository of each package . A dependency graph also names development packages. deps.dev takes most source repositories from package metadata. How the dependency graph is made
Observations
Latest Observation, Nov 9, 2026: 104 stars, 35 forks, last push Nov 2, 2026, not archived. One of 2 Observations since Nov 8, 2026.