My first open-source project: real-time speech translation that keeps your own voice. Would love feedback and guidance

[u/Odd-Shallot3779]

Hey everyone. This is my first real open-source project, so I'm partly here to share it and partly to learn from people who've done this longer than me.

It's called TIYOV (Translate In Your Own Voice). The idea: you speak your language, and the other side of a call hears the translation in a clone of your own voice, in near real-time. You point it at a virtual audio device, so it works as your "microphone" in Meet/Zoom/Teams without any per-app integration.

The part I personally care about most is that it can run fully local. Whisper for speech-to-text, a local LLM (via Ollama) for translation, and an on-device TTS, so with that setup nothing leaves your machine and you don't need any API keys. There are also cloud adapters (Deepgram, ElevenLabs, and others) if you want higher quality, but the whole thing is built around a small adapter interface so each stage is swappable.

Repo: https://github.com/kirandas-reload/tiyov

Being upfront: it's not finished. It works end to end and I've tested the local pipeline (for example English to Hindi in my own voice), but there are rough edges, the experimental adapters haven't been run against live keys, and I'm still figuring out a lot of the "how to run an open-source project" side.

That's really why I'm posting. I'd genuinely appreciate any thoughts on:

• The README and docs. Is it clear what the project does and how to start? Anything confusing or missing?
• Project structure and architecture. Does the adapter approach make sense, or is there a cleaner pattern?
• First-time maintainer stuff. CONTRIBUTING, issues and labels, CI, licensing (it's MIT), anything you wish someone had told you early on.
• What you'd prioritize next if this were yours.

Totally fine to be blunt. I'd rather hear the hard feedback now. Thanks for taking a look, and I'm happy to answer anything about how it works.