whatisgithub

What is soulx-transcriber?

soul-ailab/soulx-transcriber — explained in plain English

Analysis updated 2026-05-18

193PythonAudience · researcherComplexity · 4/5LicenseSetup · moderate

In one sentence

A research audio model that transcribes multi-speaker conversations, labeling who spoke, when, and what was said, all in one step.

Mindmap

mindmap
  root((SoulX Transcriber))
    What it does
      Multi speaker transcription
      Speaker labels
      Timestamps
    Tech stack
      Python
      Audio language model
      Hugging Face weights
    Use cases
      Meeting transcripts
      Diarization benchmarks
      Synthetic data generation
    Audience
      Researchers
      Speech engineers
    Benchmarks
      AISHELL 4
      AliMeeting
      AMI SDM

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

Transcribe multi-speaker meeting recordings with speaker labels and timestamps.

USE CASE 2

Benchmark a new diarization or transcription model against published results.

USE CASE 3

Generate synthetic multi-speaker training data from existing audio recordings.

What is it built with?

PythonHugging Face

How does it compare?

soul-ailab/soulx-transcribernolangz/pixel2motionkepengxu/prism-vl
Stars193193194
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity4/53/55/5
Audienceresearcherdesignerresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires downloading model weights from Hugging Face and a GPU for reasonable inference speed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

SoulX-Transcriber is an AI research release from Soul AI Lab and Northwestern Polytechnical University that tackles the problem of transcribing conversations involving multiple speakers. The challenge in multi-speaker transcription is producing output that answers three questions together: who spoke, when did they speak, and exactly what did they say. Most existing systems handle these questions in separate steps, which can cause errors to compound. SoulX-Transcriber trains a single model to answer all three at once. The model is a large audio language model, meaning it processes audio directly rather than converting it to an intermediate representation first. It outputs structured transcripts that include timestamps, speaker labels, and text for each utterance. A key focus of the training approach is handling real-world conversation difficulties: overlapping speech (where two people talk at the same time), fast speaker turns, and confusion between speakers with similar voices. The project reports benchmark results on three publicly available multi-speaker datasets: AISHELL-4 and AliMeeting (which are Mandarin Chinese meeting recordings) and AMI-SDM (an English meeting dataset). On AISHELL-4 and AliMeeting, SoulX-Transcriber posts the best diarization error rates (a measure of how often the model assigns speech to the wrong speaker) among the systems compared, while also achieving competitive word error rates. Comparisons include Gemini models and Qwen audio models as baselines. The repository includes the code for running transcription using the released model weights, which are hosted on Hugging Face. The training approach involves two stages: a multi-task pre-training phase that builds speaker awareness, followed by supervised fine-tuning. The project also describes a pipeline for generating synthetic training data from existing audio by matching speaker characteristics to produce more natural simulated dialogues. The model is Apache 2.0 licensed. Researchers interested in reproducing the results can download the model weights from Hugging Face and run inference using the provided scripts. A demo page with audio examples is linked from the README. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me how to download the SoulX-Transcriber weights from Hugging Face and run inference on an audio file.
Prompt 2
Explain how SoulX-Transcriber handles overlapping speech compared to older transcription pipelines.
Prompt 3
Help me evaluate SoulX-Transcriber against Gemini and Qwen audio baselines on my own meeting recordings.
Prompt 4
Walk me through the two-stage training process used to build this model.

Frequently asked questions

What is soulx-transcriber?

A research audio model that transcribes multi-speaker conversations, labeling who spoke, when, and what was said, all in one step.

What language is soulx-transcriber written in?

Mainly Python. The stack also includes Python, Hugging Face.

What license does soulx-transcriber use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is soulx-transcriber to set up?

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

Who is soulx-transcriber for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.