{"id":26775860,"url":"https://github.com/kurojs/ketsutalk","last_synced_at":"2025-06-11T14:11:33.392Z","repository":{"id":280065480,"uuid":"940169267","full_name":"kurojs/KetsuTalk","owner":"kurojs","description":"🍜👾KetsuTalk is an immersive desktop application designed to help you learn Japanese with AI-powered conversations. Combining speech recognition, text-to-speech, and dynamic interactions, KetsuTalk uses Ollama for AI-driven dialogue and VoiceVox for realistic voice synthesis.","archived":false,"fork":false,"pushed_at":"2025-03-22T00:38:14.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T04:31:19.660Z","etag":null,"topics":["desktop-app","japanese-study","language-learning","ollama-python","voicevox"],"latest_commit_sha":null,"homepage":"","language":"Python","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/kurojs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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-02-27T18:14:43.000Z","updated_at":"2025-03-22T00:38:18.000Z","dependencies_parsed_at":"2025-03-01T02:26:36.734Z","dependency_job_id":"acffcbfb-84b6-4c3c-9084-b81722517435","html_url":"https://github.com/kurojs/KetsuTalk","commit_stats":null,"previous_names":["kurojs/ketsutalk"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurojs%2FKetsuTalk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurojs%2FKetsuTalk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurojs%2FKetsuTalk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurojs%2FKetsuTalk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kurojs","download_url":"https://codeload.github.com/kurojs/KetsuTalk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurojs%2FKetsuTalk/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259280305,"owners_count":22833424,"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":["desktop-app","japanese-study","language-learning","ollama-python","voicevox"],"created_at":"2025-03-29T03:29:18.809Z","updated_at":"2025-06-11T14:11:33.200Z","avatar_url":"https://github.com/kurojs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 👾 KetsuTalk 🍜\n\n**KetsuTalk** is an immersive desktop application designed to help you learn Japanese with AI-powered conversations. Combining speech recognition, text-to-speech, and dynamic interactions, **KetsuTalk** uses **Ollama** for AI-driven dialogue and **VoiceVox** for realistic voice synthesis, providing a unique learning experience. Build your Japanese skills with the determination of a virtual sensei at your side.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/PG2Xpf7.png\" width=\"900\"/\u003e\n\u003c/p\u003e\n\nYou can watch a [video](https://i.imgur.com/p9IM8s4.mp4) to see it in action!\n\n## 👾 Project Status: Pre-Alpha 🛠️\n\nThis project is currently in **pre-alpha** development. It is a work in progress and not yet feature-complete. The main functionality is in place, but there are still many features to be added and bugs to be fixed. Expect improvements, enhancements, and new features in the future!\n\n\n## Key Features\n- **Immersive Conversations**: Engage in interactive, AI-powered conversations in Japanese.\n- **Voice Interaction**: Send and receive voice messages to practice listening and speaking skills.\n- **AI-Powered Teaching**: Get responses, corrections, and translations from a virtual sensei.\n- **Customizable**: Adjust voice settings and prompt responses to personalize your learning experience.\n- **Easy Setup**: Simple configuration for Ollama and VoiceVox integration to get started quickly.\n\n## Technologies Used\n- **Ollama**: Ollama provides the AI model for conversational dialogue. It helps generate realistic and intelligent responses.  \n  Learn more: [Ollama GitHub](https://github.com/ollama/ollama)\n  \n- **VoiceVox**: A text-to-speech engine that creates high-quality, realistic Japanese voices for the application.  \n  Learn more: [VoiceVox Guide](https://voicevox.hiroshiba.jp/how_to_use/)\n\n## Installation\nTo get started, follow these steps:\n\n### 1. Install **Ollama**  \nDownload and install **Ollama** from the official website:  \n[Ollama Downloads](https://ollama.com/)\n\n- After installation, open **PowerShell** (or your terminal) and run the following command to set up the **phi3** model:\n```bash\nollama run phi3\n```\n\n### 2. Install **VoiceVox**\nDownload and install **VoiceVox** from the official site:  \n[VoiceVox Downloads](https://voicevox.hiroshiba.jp/how_to_use/)\n\n- Ensure you have **VoiceVox** running locally (usually on port 50021).\n\n### 3. Clone the Repository\nClone the repository to your local machine:\n```bash\ngit clone https://github.com/kurojs/KetsuTalk.git\n```\n\n### 4. Install Python Dependencies\nBefore running the application, you need to install the required Python dependencies. Run the following command to install them:\n\n```bash\npip install speechrecognition pydub requests translate keyboard\n```\n\n### 5. Run the Application\nExecute the main Python script to start the application:\n```bash\npython main.py\n```\n\n## Future Plans\n- **Desktop App**: Full-featured multilingual desktop application with an intuitive interface.\n- **Advanced Features**: Editable prompts, more voice options, and personalized learning experiences.\n- **Enhanced Conversations**: More dynamic conversations and corrections to simulate real-life interactions.\n\n## Contributing\nFeel free to fork the repository, open issues, and submit pull requests. Contributions are always welcome!\n\n---\n\n### License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurojs%2Fketsutalk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkurojs%2Fketsutalk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurojs%2Fketsutalk/lists"}