anyspeak

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #golang #go #android #machine-learning #rust #linux #macos #vue #pytorch #ios

(★ 4)

Let any text speak with AnySpeak.ai – text to speech powered by Qwen3-TTS - Web UI & CLI - Open Source

anyspeak Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AnySpeak.ai

→ <a href="https://anyspeak.ai">Listen to speech examples</a> ←

**→ The app is already online. You can try it at [anyspeak.ai](https://anyspeak.ai).**

**Let any text speak.** Open-source text-to-speech powered by [Qwen3-TTS](https://github.com/QwenLM/Qwen3-TTS), with a web UI and optional local CLI.

---

## Screenshots

| View - Player | View - Editor |
|---------------|---------------|
| [![View - Player](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/View%20-%20Player.png)](screenshots/View%20-%20Player.png) | [![View - Editor](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/View%20-%20Editor.png)](screenshots/View%20-%20Editor.png) |

| Feature - CLEAN | Feature - Quality |
|-----------------|-------------------|
| [![Feature - CLEAN](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/Feature%20-%20CLEAN.png)](screenshots/Feature%20-%20CLEAN.png) | [![Feature - Quality](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/Feature%20-%20Quality.png)](screenshots/Feature%20-%20Quality.png) |

| Feature - IMPROVE | Feature - VIDEO |
|-------------------|-----------------|
| [![Feature - IMPROVE](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/Feature%20-%20IMPROVE.png)](screenshots/Feature%20-%20IMPROVE.png) | [![Feature - VIDEO](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/Feature%20-%20VIDEO.png)](screenshots/Feature%20-%20VIDEO.png) |

| View - Moods | Feature - Community |
|--------------|---------------------|
| [![View - Moods](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/View%20-%20Moods.png)](screenshots/View%20-%20Moods.png) | [![Feature - Community](https://raw.githubusercontent.com/anyspeak-ai/anyspeak/main/screenshots/Feature%20-%20Community.png)](screenshots/Feature%20-%20Community.png) |

---

## ✨ Features

- **TTS:** Multiple voices and Qwen3-TTS models (1.7B CustomVoice, VoiceDesign, Base). Supported languages: Chinese, English, French, German, Italian, Japanese, Korean, Portuguese, Russian, Spanish.
- **Speaker tags:** Use `[SPEAKER_NAME]` in text for multi-speaker output.
- **Mood tags:** Use `[SPEAKER:mood]` (e.g. `[VIVIAN:happy]`) for emotional expressiveness.
- **Timing tags:** Use `[SPEAKER:mood:timing]` (e.g. `[RYAN:+1.5]` for 1.5 s pause after, `[VIVIAN:happy:-0.3]` for shorter gap or even speaker overlapping) or the + TIMING button to control pacing between segments.
- **Custom voices:** Voice Design by selecting attributes (gender, language, old/young, slow/fast, high/low, loud/soft, warm/rough).
- **CLEAN:** Analyze and clean text for better TTS output.
- **CHECK:** Quality check with Whisper (compare original vs. synthesized).
- **IMPROVE:** Post-process generated audio by chunk: selectively regenerate mispronounced segments, trim silence, add pauses, or edit text and re-generate. Compare original vs. improved before applying. You can also edit finished MP3s afterward (e.g. different wording or different speaker at a specific place) without regenerating everything.
- **VIDEO:** Create video from audio and images (with optional subtitles).
- **Load & Save (MP3):** Load and save via MP3. Very powerful: you can continue working at the same place, and files store the original text with tags in their metadata.
- **Import:** Load text from URL or file.
- **Local CLI:** [run_local.py](run_local.py) for offline generation (see [RUN_LOCAL_INSTRUCTIONS.txt](RUN_LOCAL_INSTRUCTIONS.txt)).

---

## ⚙️ Requirements

- Python 3.10+ (3.12 recommended)
- **Hardware:** x86_64 CPU with AVX support (typical Intel/AMD from ~2011 onward), 8 GB free RAM minimum

FFmpeg and all other dependencies are installed automatically on first run.

---

## 📦 Installation

1. **Clone the repo** and ensure [Python 3.10+](https://www.python.org/downloads/) is installed (3.12 recommended).  
   Windows: During installation, check *Add Python to PATH*.

2. **Run the script** — that’s it. On first run, `run_local.py` installs everything (venv, packages, FFmpeg, TTS model) automatically. No manual `pip install` or model downloads needed.

```bash
git clone https://github.com/anyspeak-ai/anyspeak.git
cd anyspeak
python run_local.py "Hello world" -o hello.mp3
```

First run takes ~10–20 minutes (downloads ~5 GB). Later runs convert immediately.

See [RUN_LOCAL_INSTRUCTIONS.txt](RUN_LOCAL_INSTRUCTIONS.txt) for details (platform-specific notes, server mode, troubleshooting).

---

## ▶️ Usage

### CLI (text → MP3)

```bash
python run_local.py input.txt -o output.mp3
python run_local.py "[RYAN] Hello world" -o hello.mp3
```

### Web UI (full features)

```bash
python run_local.py --server
```

Then open [http://localhost:5000](http://localhost:5000). Server mode downloads additional models (~15 GB total) on first run.

See [RUN_LOCAL_INSTRUCTIONS.txt](RUN_LOCAL_INSTRUCTIONS.txt) for options (custom port, reinstall, uninstall).

---

## 📁 Project layout (main files)

| Path | Description |
|------|-------------|
| `run_local.py` | All-in-one CLI and server launcher (first run installs everything) |
| `RUN_LOCAL_INSTRUCTIONS.txt` | Local usage guide |
| `LICENSE` | AGPL-3.0 license |
| `app.py` | Flask server and TTS API |
| `config.py` | Central configuration |
| `index.html` | Main web UI |
| `footer.json` | Footer content (privacy, terms, license, contact, GitHub URL) |
| `communityfeatures.html` / `communityfeatures.py` | Community features page |
| `feature_*.html` / `feature_*.py` | Feature modules (clean, check, improve, video, timing, custom voice, import) |
| `utils_whisper.py` | Whisper for quality check |
| `provenance.py` | Proof of origin: metadata, Ed25519 signature, audio watermark |
| `provenance_detect.py` | CLI tool to verify provenance in MP3/MP4/WAV files |
| `provenance_hashes.json` | Provenance configuration (hashes, signing key, auto-sign) |

---

## Proof of Origin

Every generated file gets an inaudible watermark and metadata. Files can optionally be **signed with Ed25519** to prove their origin. Toggle auto-signing in `provenance_hashes.json`:

```json
"sign_automatically": true
```

Set to `false` to skip signing on export. You can always sign or verify manually:

```bash
python provenance.py --generate-keys          # first-time: create key pair
python provenance.py --sign-file output.mp3    # sign an existing file
python provenance_detect.py output.mp3         # verify provenance
```

---

<a id="roadmap"></a>
## 🗺️ Roadmap

**Preprocessing**
- Improved CLEAN feature (e.g. add spelling check)
- Improved custom voice feature (e.g. add voice cloning)

**Postprocessing**
- Improved IMPROVE feature (e.g. add speed management)

**New features**
- MCP as universal API (JSON in → MP3 out)
- Batch processing
- Sound effect library and integration (like video feature)

---

## 📄 License

AnySpeak is open source under **AGPL-3**. You may use, modify, and distribute it. If you modify it or offer it as a service, you must make the source code available to users under AGPL-3. If you prefer not to do that, a **commercial license** is available – [hello@anyspeak.ai](mailto:hello@anyspeak.ai).

---

## 💬 Community

- **Community features:** Contribute improvements or add plugins/integrations on the Community Features page.
- You can work on [Roadmap](#roadmap) items or bring your own ideas – best integrated as community features.
- **Contributing:** By submitting a pull request, you agree to the [Contributor License Agreement (CLA)](CLA.md).
- **GitHub ⭐ stars** are welcome if you like the project: [github.com/anyspeak-ai/anyspeak](https://github.com/anyspeak-ai/anyspeak)

---

## 🙏 Acknowledgments

Thanks to the following projects and communities that make AnySpeak possible:

- **[Qwen3-TTS](https://github.com/QwenLM/Qwen3-TTS)** by Alibaba Cloud / QwenLM — the core TTS engine
- **[OpenAI Whisper](https://github.com/openai/whisper)** — used for quality checking and text comparison
- **[Hugging Face](https://huggingface.co)** — model hosting and distribution

anyspeak

anyspeak Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

anyspeak

anyspeak Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README