gitwtfhub

wtf is emotivoice?

netease-youdao/emotivoice — explained in plain English

Analysis updated 2026-06-24

8,480PythonAudience · developerComplexity · 3/5LicenseSetup · hard

TL;DR

EmotiVoice is an open-source text-to-speech system that generates expressive speech in English and Chinese with control over emotion, happy, sad, angry, across more than 2,000 voices.

Mindmap

mindmap
  root((repo))
    What it does
      Text to speech
      Emotion control
      2000 plus voices
    Features
      English and Chinese
      OpenAI API compatible
      Voice cloning
    Tech Stack
      Python
      Docker
      CUDA
    Audience
      Content creators
      App developers

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

Why would anyone build with this?

REASON 1

Generate emotional voice narration for a game character or interactive story application

REASON 2

Build a content pipeline that converts text to expressive speech in English or Chinese

REASON 3

Replace an OpenAI TTS integration with a self-hosted alternative using the same API format

What's in the stack?

PythonDockerCUDAconda

How it stacks up

netease-youdao/emotivoicegetmoto/motomrexodia/ida-pro-mcp
Stars8,4808,4808,479
LanguagePythonPythonPython
Setup difficultyhardeasyhard
Complexity3/52/54/5
Audiencedeveloperdeveloperresearcher

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires an NVIDIA GPU for local inference, Docker is the easiest path but still needs GPU access.

Free to use for any purpose, including commercial use, with attribution under Apache 2.0.

Wtf does this do

EmotiVoice is an open-source text-to-speech system that can generate spoken audio from text in both English and Chinese, with control over the emotional tone of the output. When you give it text, you also specify an emotion such as happy, sad, angry, or excited, and the system generates speech that reflects that emotion rather than neutral, flat delivery. It offers more than 2,000 distinct voices to choose from. The most distinctive aspect compared to basic text-to-speech tools is the prompt-controlled emotion feature. Instead of just converting words to audio, you tell the system how you want the speaker to sound, and it adjusts pitch, speed, and energy accordingly. This makes it useful for content creators, game developers, or anyone building applications that need expressive rather than robotic-sounding speech. There are several ways to use it. The quickest is through a Docker container: you pull a pre-built image, run it, and access a web interface in your browser. A full local installation uses Python with conda and pip. The system also exposes an API that is compatible with the OpenAI text-to-speech API format, meaning software already built to use OpenAI's speech service could switch to EmotiVoice with minimal changes. A Mac desktop app was also released as a download. Voice cloning is supported, allowing users to fine-tune the system on their own audio recordings to produce speech in a custom voice. A GPU is required for inference, specifically an NVIDIA GPU when running locally or via Docker. The project was created by Netease Youdao and is released under the Apache 2.0 license.

Yoink these prompts

Prompt 1
Show me how to run EmotiVoice in Docker and generate speech that sounds excited for a product announcement script
Prompt 2
Help me use EmotiVoice's OpenAI-compatible API to replace my current TTS setup with minimal code changes
Prompt 3
How do I fine-tune EmotiVoice on my own voice recordings to clone my voice for audio content?

Frequently asked questions

wtf is emotivoice?

EmotiVoice is an open-source text-to-speech system that generates expressive speech in English and Chinese with control over emotion, happy, sad, angry, across more than 2,000 voices.

What language is emotivoice written in?

Mainly Python. The stack also includes Python, Docker, CUDA.

What license does emotivoice use?

Free to use for any purpose, including commercial use, with attribution under Apache 2.0.

How hard is emotivoice to set up?

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

Who is emotivoice for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.