{"id":27027940,"url":"https://github.com/ethanngit/mandarinankigenerator","last_synced_at":"2026-05-01T19:34:20.460Z","repository":{"id":286185162,"uuid":"960648469","full_name":"EthanNgit/MandarinAnkiGenerator","owner":"EthanNgit","description":"Generate Anki decks about any topic. ZH -\u003e EN.","archived":false,"fork":false,"pushed_at":"2025-04-06T18:09:38.000Z","size":161,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T18:18:39.459Z","etag":null,"topics":["ai","anki","artificial-intelligence","chinese","flashcards","mandarin"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EthanNgit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-04T19:57:47.000Z","updated_at":"2025-04-06T18:09:42.000Z","dependencies_parsed_at":"2025-04-04T20:34:38.607Z","dependency_job_id":"7136d34c-fcb8-47de-906a-2ff5afb30263","html_url":"https://github.com/EthanNgit/MandarinAnkiGenerator","commit_stats":null,"previous_names":["ethanngit/mandarinankigenerator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanNgit%2FMandarinAnkiGenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanNgit%2FMandarinAnkiGenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanNgit%2FMandarinAnkiGenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanNgit%2FMandarinAnkiGenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EthanNgit","download_url":"https://codeload.github.com/EthanNgit/MandarinAnkiGenerator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085326,"owners_count":21045139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","anki","artificial-intelligence","chinese","flashcards","mandarin"],"created_at":"2025-04-05T00:18:38.945Z","updated_at":"2026-05-01T19:34:20.386Z","avatar_url":"https://github.com/EthanNgit.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 Mandarin Anki Deck Generator\n\nCreate personalized Mandarin ➝ English Anki decks on *any* topic — powered by the latest AI models, seamless text-to-speech, and flexible pinyin support.\n\n---\n\n## 🚀 What Is This?\n\nThis project lets you easily generate high-quality Anki decks with Mandarin vocabulary and English translations, with support for:\n\n- 🎯 *Your* topics and prompts\n- 💬 AI-powered content generation (currently supports OpenAI, DeepSeek, and Gemini)\n- 🔊 Audio pronunciation (currently supports Google TTS or Azure TTS)\n- 🈶 Customizable pinyin formats (numbered, marked, and zhuyin)\n\n---\n\n## 🧩 How It Works\n\nThe system is built with **Docker Compose** and made up of 3 main microservices working together:\n\n### 1. 🖥️ The Server (Deck Engine)\n\nThis is the brain of the system. It connects everything together:\n\n- Talks to the AI model to generate vocabulary and sentences\n- Calls the pinyin converter to get your preferred pinyin format\n- Integrates TTS audio into the final Anki cards\n- Outputs a `.apkg` file ready to import into Anki\n\n### 2. 🔊 TTS Service\n\nAdd native-like pronunciation to your flashcards!\n\n- Supports the use of **Google Text-to-Speech** or **Azure TTS**\n- Generates clean `.wav` files for each vocabulary item efficiently by slicing batch api requests\n- Automatically links audio to the Anki card\n\n### 3. 🀄 Pinyin Converter\n\nDifferent learners prefer different pinyin styles. This service makes that easy:\n\n- Convert Mandarin to pinyin in multiple formats (e.g., numbered tones, tone marks, no tones, zhuyin)\n- Helps learners hear, see, and internalize pronunciation more effectively\n\n---\n\n## 🛠️ Todo\n\n1. Add client interface\n2. Add more deck customization (themes)\n3. Add grammar structure based cards and support\n4. Tagging words for searching\n5. Sharing decks\n6. Expanding decks\n7. Importing and improving decks\n8. Explore ai tts options for better pronounciation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethanngit%2Fmandarinankigenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethanngit%2Fmandarinankigenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethanngit%2Fmandarinankigenerator/lists"}