Skip to main content

Dolphin

Paper Github Huggingface Modelscope

Dolphin is a multilingual, multitask ASR model developed through a collaboration between Dataocean AI and Tsinghua University. It supports 40 Eastern languages across East Asia, South Asia, Southeast Asia, and the Middle East, while also supporting 22 Chinese dialects. It is trained on over 210,000 hours of data, which includes both DataoceanAI's proprietary datasets and open-source datasets. The model can perform speech recognition, voice activity detection (VAD), segmentation, and language identification (LID).

Approach

Mulitask data format Dolphin largely follows the innovative design approach of Whisper and OWSM. A joint CTC-Attention architecture is adopted, with encoder based on E-Branchformer and decoder based on standard Transformer. Several key modifications are introduced for its specific focus on ASR. Dolphin does not support translation tasks, and eliminates the use of previous text and its related tokens.

A significant enhancement in Dolphin is the introduction of a two-level language token system to better handle linguistic and regional diversity, especially in Dataocean AI dataset. The first token specifies the language (e.g., <zh>, <ja>), while the second token indicates the region (e.g., <CN>, <JP>). See details in paper.

Setup

Dolphin requires FFmpeg to convert audio file to WAV format. If FFmpeg is not installed on your system, please install it first:

# Ubuntu or Debian
sudo apt update && sudo apt install ffmpeg

# MacOS
brew install ffmpeg

# Windows
choco install ffmpeg

You can install the latest version of Dolphin using the following command:

pip install -U dataoceanai-dolphin

Alternatively, it can also be installed from the source:

pip install git+https://github.com/SpeechOceanTech/Dolphin.git 

Available Models and Languages

Models

There are 4 models in Dolphin, and 2 of them are available now. See details in paper.

Model Parameters Average WER Publicly Available
base 140 M 33.3 ✅
small 372 M 25.2 ✅
medium 910 M 23.1
large 1679 M 21.6

Languages

Dolphin supports 40 Eastern languages and 22 Chinese dialects. For a complete list of supported languages, see languages.md.

Usage

Command-line usage

dolphin audio.wav

# Download model and specify the model path
dolphin audio.wav --model small --model_dir /data/models/dolphin/

# Specify language and region
dolphin audio.wav --model small --model_dir /data/models/dolphin/ --lang_sym "zh" --region_sym "CN"

# padding speech to 30 seconds
dolphin audio.wav --model small --model_dir /data/models/dolphin/ --lang_sym "zh" --region_sym "CN" --padding_speech true

Python usage

import dolphin

waveform = dolphin.load_audio("audio.wav")
model = dolphin.load_model("small", "/data/models/dolphin", "cuda")
result = model(waveform)
# Specify language and region
result = model(waveform, lang_sym="zh", region_sym="CN")
print(result.text)

License

Dolphin's code and model weights are released under the Apache 2.0 License.

Metadata

Release files for dataoceanai-dolphin 20250327

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dataoceanai-dolphin 20250327
File Size Uploaded
dataoceanai-dolphin-20250327.tar.gz 608.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for dataoceanai-dolphin 20250327
File Interpreter ABI Platform
dataoceanai_dolphin-20250327-py3-none-any.whl Python 3 none any Details

Total release size: 1.2 MB

Release files / dataoceanai-dolphin-20250327.tar.gz

Download URL dataoceanai-dolphin-20250327.tar.gz
Size 608.4 kB
Tags Source
SHA-256 checksum
How to use checksums
d29d4c970aab99e091ba46ff1bb457e12fecfd7e654a4c60e9f613ec7ae23cca
BLAKE2b-256 checksum
How to use checksums
5bde700a6077bad2356e8e4cef8c9cf5adf42a496f0882fe5b7ff67e53326cf9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.16

Release files / dataoceanai_dolphin-20250327-py3-none-any.whl

Download URL dataoceanai_dolphin-20250327-py3-none-any.whl
Size 614.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
85c22272a9c981dd1fa0e9c8b9b5bd0635f00e42c13f99f536703b3746309750
BLAKE2b-256 checksum
How to use checksums
061e4cd6631f244a8a7fb13547dc89c612af507e6c8cc5dbdb095694e6c287ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.16

Release history Release notifications | RSS feed

This release

20250327 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page