STTS | Wikispeech

Wikimedia's official information about the project: www.mediawiki.org/wiki/Wikispeech

1. Installation instructions for the MVP version as of April 2026

Updated 2026-04-13. These instructions are currently being updated, and is a work in progress (Q2, 2026). To make sure you get the latest version of instructions, please use shift-reload (or shift-ctrl-R) to override cache.

1.1 Software

Below is a list of components to install for Wikispeech. Go to each git repo (linked below), and follow installation instructions in the README file.

MVP2 dev version 2026-04:1 (in progress)

Symbolset			Symbolset/mapping server
Pronlex			Lexicon server
Matcha TTS			Adapter for Matcha TTS
Piper TTS			Adapter for Piper TTS
Textproc			Text processing component
Wikispeech-server			The main Wikispeech-server

MVP test version 2026-03

Symbolset			Symbolset/mapping server	Commit ID: d2a631c
Wikispeech-lexdata	Build status: n/a		Lexicon data with symbol sets	Commit ID: 2e6d2df
Pronlex			Lexicon server	Commit ID: f972e81
Piper TTS			Adapter for Piper TTS	Commit ID: 439d7c5
Textproc			Text processing component	Commit ID: 439d7c5
Wikispeech-server			The main Wikispeech-server	Commit ID: 6227e26

1.2 Language models

Info on TTS voices for Wikispeech MVP2 2026-04

# 1. Install gdown
uv venv --allow-existing
source .venv/bin/activate
uv pip install gdown

# 2. Create folders
mkdir -p $HOME/.local/share/deep_phonemizer
mkdir -p $HOME/.local/share/piper_tts
mkdir -p $HOME/.local/share/matcha_tts

# 3. Deep phonemizer for Swedish
gdown https://drive.google.com/uc?id=1H1BCPlOkKBfhz3wacvBDCv_9B8bmgPzA -O $HOME/.local/share/deep_phonemizer/dp_single_char_swe_sv.pt

# 4. US English voices for Piper
gdown https://drive.google.com/uc?id=1F_tBp6MiExQ-yVKqYLmvR2u1v4RRb0WL -O $HOME/.local/share/piper_tts/en_US-ljspeech-high.onnx
gdown https://drive.google.com/uc?id=1nx1TVW1PdOe51p9IfA7fczqRP-mbFIC_ -O $HOME/.local/share/piper_tts/en_US-ljspeech-high.onnx.json
gdown https://drive.google.com/uc?id=1niTGWHPc_iQb1fz3Tdw057IqpUFBndpW -O $HOME/.local/share/piper_tts/en_US-bryce-medium.onnx
gdown https://drive.google.com/uc?id=1Z_-H_2z900qUz8qcgB73FPL2DcN80k-_ -O $HOME/.local/share/piper_tts/en_US-bryce-medium.onnx.json

# 5. Swedish voices for Piper
gdown https://drive.google.com/uc?id=1ONhMrjIRCWI5eBObcWgECmMWR5UcOSVO -O $HOME/.local/share/piper_tts/sv_vc_male_mart2nik.onnx.json
gdown https://drive.google.com/uc?id=1dAGnXYv_20Ga-neVOA-EFYQth6rh-D0b -O $HOME/.local/share/piper_tts/sv_vc_male_mart2nik.onnx
gdown https://drive.google.com/uc?id=14d_f9NL2-rLnG8I8wvHF5UZvIyLt_5uj -O $HOME/.local/share/piper_tts/sv_vc_female_mart2han.onnx.json
gdown https://drive.google.com/uc?id=11RLjC2g1T6L7cIdqsnaDG21Ze72KveEB -O $HOME/.local/share/piper_tts/sv_vc_female_mart2han.onnx

# 6. Base models for Matcha
curl -L https://github.com/shivammehta25/Matcha-TTS-checkpoints/releases/download/v1.0/generator_v1 -o $HOME/.local/share/matcha_tts/hifigan_T2_v1
curl -L https://github.com/shivammehta25/Matcha-TTS-checkpoints/releases/download/v1.0/g_02500000   -o $HOME/.local/share/matcha_tts/hifigan_univ_v1
curl -L https://github.com/shivammehta25/Matcha-TTS-checkpoints/releases/download/v1.0/matcha_ljspeech.ckpt -o $HOME/.local/share/matcha_tts/matcha_ljspeech.ckpt
gdown https://drive.google.com/uc?id=1TXq4_gEHvZlwxN4Z5Fzo4C6474Nb9iEa -O $HOME/.local/share/matcha_tts/matcha_ljspeech.json
curl -L https://github.com/shivammehta25/Matcha-TTS-checkpoints/releases/download/v1.0/matcha_vctk.ckpt -o $HOME/.local/share/matcha_tts/matcha_vctk.ckpt
gdown https://drive.google.com/uc?id=19co5C25iGojvqhyjaQokj-4VoBSrUQl_ -O $HOME/.local/share/matcha_tts/matcha_vctk.json

# 7. Swedish voices for Matcha
gdown https://drive.google.com/uc?id=1LEJA3ESv5SRZ5mO1Cd3STY0Iga-WIoCT -O $HOME/.local/share/matcha_tts/sv_vc_female_mart2han.ckpt
gdown https://drive.google.com/uc?id=1JJniKbVunr1iF4Qr6unr58OSt86rFASR -O $HOME/.local/share/matcha_tts/sv_vc_female_mart2han.json
gdown https://drive.google.com/uc?id=1dXkPDgebUveDRK9OsCnGmhZaIVrY9aOm -O $HOME/.local/share/matcha_tts/sv_vc_male_mart2nik.ckpt
gdown https://drive.google.com/uc?id=1-znBB5Bh08Rq0SEO5nZKmwE0xITdagYc -O $HOME/.local/share/matcha_tts/sv_vc_male_mart2nik.json

2. Running Wikispeech

For MVP2, use the following config files:

• Wikispeech-server: wikispeech-server/config_mvp2.conf
• Piper: wikispeech-tts-wrappers/piper_server/config_mvp2.env
• Matcha: wikispeech-tts-wrappers/matcha_server/config_mvp2.env
• Textproc: wikispeech-tts-wrappers/textproc/config_mvp2.env

Convenience scripts for running the full standard setup with all servers:

• start_wikispeech.sh
  
• stop_wikispeech.sh

If you want to start each server separately, please see each repo's README file for details. You can also have a look at the start_wikispeech.sh script for clues. Please note that the sub-servers must be up and running before the main Wikispeech server can be started.

3. API documentation

When you have installed and started the Wikispeech server, you can find the API documentation in the URLs below. (Examples for servers located on localhost, with default ports.)

Main API/Wikispeech server: http://localhost:10000

Sub-servers:

• Symbolset server: http://localhost:8771
• Lexicon server: http://localhost:8787
• Matcha TTS: http://localhost:8009/docs
• Piper TTS: http://localhost:8010/docs
• Textproc: http://localhost:8011/docs

4. More information

An UML diagram over the Wikispeech server: github.com/stts-se/wikispeech-server/wiki/uml/basic.png

Github repositories

Main repos

• wikispeech-server
• pronlex
• symbolset
• wikispeech-lexdata
• wikispeech-tts-wrappers – other components and wrappers

Self-financed repos

• lexdata
• decomp
• rbg2p
• wstats

---

This work was supported by the Swedish Post and Telecom Authority (PTS) through the grant "Wikispeech – en användargenererad talsyntes på Wikipedia" (2016–2017), and by Swedish Inheritance Fund ("Allmänna Arvsfonden") through the grant "Wikispeech Talsyntes och taldatainsamlare" (2024–2026).

© STTS Södermalms talteknologiservice 2018-2026 | stts.se