explaingit

zhaoyx239/x-translator

Analysis updated 2026-05-18

25PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

TLDR

A real-time speech-to-speech translation system that listens, translates, and speaks back the translation live, built from a research paper.

Mindmap

mindmap
  root((X Translator))
    What it does
      Live speech translation
      Speaks back translation
      Shows source and target text
    Tech stack
      Python
      FastAPI
      PyTorch
    Use cases
      Live demo translation
      Swap ASR MT TTS backends
      Research reference code
    Audience
      Researchers
      Speech engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Try or demo a live speech-to-speech translation pipeline with speaker-aware audio output.

USE CASE 2

Swap in different ASR, translation, and TTS backends to compare speech translation quality.

USE CASE 3

Study or extend the reference implementation behind the X-Translator research paper.

What is it built with?

PythonFastAPIPyTorchCUDA

How does it compare?

zhaoyx239/x-translatoralexrosbach/replibookarlandaren/proagents
Stars252525
LanguagePythonPythonPython
Setup difficultyhardeasyeasy
Complexity4/52/51/5
Audienceresearcherops devopsvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires running separate ASR, translation, and TTS backend services before the demo works, and a GPU for the CUDA build.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, third-party components keep their own licenses.

In plain English

X-Translator is a research system that translates speech in real time while someone is talking, and speaks the translation back in the target language. It connects three pieces: a speech recognition model that listens to the speaker, a translation model that converts the recognized text, and a text to speech model that reads the translation aloud, all coordinated by a runtime controller. A browser page can show the original text, the translated text, and play the synthesized voice as the conversation happens. The project comes from a research group and includes a published paper describing the design, along with a public online demo you can try without installing anything. This release includes the local demo and the backend adapters that connect to different speech recognition, translation, and text to speech services. The code for formally evaluating the system's accuracy is planned for a later release. The repository is organized into a FastAPI backend that runs the session logic and runtime controller, a simple browser frontend, and a server folder holding adapters and setup notes for each supported speech and translation service. To run it yourself, you set up a Python virtual environment, install the project, and optionally install a CUDA build of PyTorch if you have a compatible GPU. Configuration happens through a single config.json file, where you choose which speech recognition engine to use, such as Qwen3, SenseVoice, Paraformer, or Zipformer, which translation engine, such as LMT or Hunyuan, and which text to speech engine, such as X-Voice or IndexTTS, along with the source and target languages. Those backend services need to be started separately before launching the browser demo with the included start script. The project credits several existing open source speech recognition, translation, and text to speech projects that its adapters connect to. X-Translator's own code is released under the MIT License, though the third-party models and services it can connect to keep their own separate licenses.

Copy-paste prompts

Prompt 1
Help me set up X-Translator locally and pick which ASR, translation, and TTS providers to configure in config.json.
Prompt 2
Explain how X-Translator's runtime controller keeps the ASR, translation, and TTS pipeline in sync during a live session.
Prompt 3
I have a CUDA 12.4 GPU. Walk me through installing the matching PyTorch build for X-Translator.
Prompt 4
What do I need to run in the server folder before I can launch the X-Translator browser demo with start.sh?

Frequently asked questions

What is x-translator?

A real-time speech-to-speech translation system that listens, translates, and speaks back the translation live, built from a research paper.

What language is x-translator written in?

Mainly Python. The stack also includes Python, FastAPI, PyTorch.

What license does x-translator use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, third-party components keep their own licenses.

How hard is x-translator to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is x-translator for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.