goruut

README

Goruut

A tokenizer, text cleaner, and IPA phonemizer for several human languages.

Try it online

It is possible to try this software live at hashtron.cloud.

Installation

go install github.com/neurlang/goruut/cmd/goruut@latest

Docker Compose installation

Clone the repo and then run in root directory this command:

sudo docker compose up -d --force-recreate --build

Supported Languages

• English
• Spanish
• German
• French
• Italian
• Arabic
• Farsi
• Luxembourgish
• Dutch
• Portuguese
• Russian
• Swedish
• Czech
• Slovak
• Romanian
• Finnish
• Isan
• Swahili
• Esperanto
• Icelandic
• Norwegian
• Jamaican
• Japanese
• Hindi
• Bengali
• Bengali Dhaka
• Bengali Rahr
• Punjabi
• Telugu
• Marathi
• Chinese Mandarin
• Tamil
• Gujarati
• Urdu
• Turkish
• Vietnamese Northern
• Vietnamese Central
• Vietnamese Southern
• Polish
• Greek
• Ukrainian
• Hungarian
• Malay Latin
• Malay Arab

The goal is to support all of voice2json's languages. Please Add a language if you have the necessary data.

Listening to the generated speech

There are currently 3 target languages (IPA flavors). They are:

• IPA - Copy the output into ipa-reader.xyz and pick a correct language voice
• Espeak - Copy the output into espeak. For example czech: espeak -v cs "[[ru:Zovi: ku:n^]]"
• Antvaset - Copy the output into antvaset.com and pick a correct language voice

Dependencies

See go.mod file for an up-to-date list of depended-on projects. Minimum supported version of golang is go 1.18 (project uses type parameters).

Numbers, Dates, and More

Unsupported. Please write them using words.

Command-Line Usage

To start, launch the server using the example config (in configs dir):

./goruut -configfile configs/config.json

This will launch the server at a specific http port. You should see the port which you specified in the config file:

INFO[0000] Binding port: 18080

Then you can run queries:

POST http://127.0.0.1:18080/tts/phonemize/sentence

{
	"Language": "Czech",
	"Sentence": "jsem supr"	
}

Output should be:

{
	"Words": [
		{
			"Linguistic": "jsem",
			"Phonetic": "jsɛm"
		},
		{
			"Linguistic": "supr",
			"Phonetic": "supr"
		}
	]
}

Intended Audience

goruut is useful for transforming raw text into phonetic pronunciations, similar to phonemizer. Unlike phonemizer, goruut looks up words in a pre-built lexicon (pronunciation dictionary) or guesses word pronunciations with a pre-trained grapheme-to-phoneme model.