Metadata-Version: 2.5
Name: vozonda
Version: 0.7.4
Summary: Vozonda orchestrator: url to two-voice podcast dialogue
Project-URL: Homepage, https://vozonda.com
Project-URL: Repository, https://github.com/Vozonda/vozonda
Project-URL: Documentation, https://github.com/Vozonda/vozonda#readme
Project-URL: Bug Tracker, https://github.com/Vozonda/vozonda/issues
Project-URL: Changelog, https://github.com/Vozonda/vozonda/blob/main/CHANGELOG.md
Author-email: Vozonda <vozonda@proton.me>
License: MIT
Keywords: ai,audio,overview,podcast,private,rss,sovereign,tts,voice
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.11
Requires-Dist: coincurve>=21.0.0
Requires-Dist: fastapi>=0.115
Requires-Dist: httpx>=0.28
Requires-Dist: lxml-html-clean>=0.4
Requires-Dist: pillow>=10
Requires-Dist: pydantic>=2.10
Requires-Dist: readability-lxml>=0.8.4.1
Requires-Dist: uvicorn[standard]>=0.34
Provides-Extra: mcp
Requires-Dist: mcp>=1.9; extra == 'mcp'
Provides-Extra: stt
Requires-Dist: av<19,>=11; extra == 'stt'
Requires-Dist: faster-whisper>=1.1; extra == 'stt'
Provides-Extra: tts
Requires-Dist: av<19,>=11; extra == 'tts'
Requires-Dist: faster-whisper>=1.1; extra == 'tts'
Requires-Dist: kokoro-onnx>=0.4; extra == 'tts'
Requires-Dist: numpy>=1.26; extra == 'tts'
Requires-Dist: numpy>=1.26.0; extra == 'tts'
Requires-Dist: piper-tts>=1.2.0; extra == 'tts'
Requires-Dist: qwen-tts>=0.1.0; extra == 'tts'
Requires-Dist: soundfile>=0.12; extra == 'tts'
Requires-Dist: soundfile>=0.12.0; extra == 'tts'
Requires-Dist: torch>=2.2.0; extra == 'tts'
Provides-Extra: tts-kokoro
Requires-Dist: kokoro-onnx>=0.4; extra == 'tts-kokoro'
Requires-Dist: numpy>=1.26; extra == 'tts-kokoro'
Requires-Dist: soundfile>=0.12; extra == 'tts-kokoro'
Provides-Extra: tts-piper
Requires-Dist: piper-tts>=1.2.0; extra == 'tts-piper'
Provides-Extra: tts-qwen
Requires-Dist: numpy>=1.26.0; extra == 'tts-qwen'
Requires-Dist: qwen-tts>=0.1.0; extra == 'tts-qwen'
Requires-Dist: soundfile>=0.12.0; extra == 'tts-qwen'
Requires-Dist: torch>=2.2.0; extra == 'tts-qwen'
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/Vozonda/vozonda/main/brand/vozonda-lockup-dark.svg#gh-dark-mode-only" alt="Vozonda" width="360">
  <img src="https://raw.githubusercontent.com/Vozonda/vozonda/main/brand/vozonda-lockup.svg#gh-light-mode-only" alt="Vozonda" width="360">
</p>

<h3 align="center">Turn sources into your podcast</h3>

<p align="center">
  <em>Vozonda reads them, voices make waves, you listen.</em>
</p>

<p align="center">
  <a href="https://pypi.org/project/vozonda/"><img src="https://img.shields.io/pypi/v/vozonda.svg" alt="PyPI"></a>
  <a href="https://www.npmjs.com/package/vozonda"><img src="https://img.shields.io/npm/v/vozonda.svg" alt="npm"></a>
  <a href="https://github.com/Vozonda/vozonda/pkgs/container/vozonda"><img src="https://img.shields.io/badge/docker-ghcr.io-238636?logo=docker&logoColor=white" alt="GHCR"></a>
  <a href="https://github.com/Vozonda/vozonda/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-4a7300" alt="MIT licence"></a>
  <a href="https://vozonda.com"><img src="https://img.shields.io/badge/website-vozonda.com-1a1815" alt="Website"></a>
</p>

---

## What is Vozonda?

Give Vozonda articles, papers, PDFs, audio files, podcast episodes, screenshots, YouTube videos, RSS feeds or your own notes, and it turns them into the show you want. Audio sources are transcribed locally.

- **Fourteen show formats:** deep dive, quick brief, debate, critique, morning dispatch of your feeds, feature story, explainer, three-voice roundtable, and more.
- **One to three voices, or a single narrator:** in ten languages; translates sources into the language you want to hear.
- **Watchlists:** turn RSS feeds into a daily or weekly digest that fills your feed automatically.
- **Every episode comes with:** chapters, transcripts, takeaways, highlights, and shareable clips; read and fix the script before it is voiced.
- **Self-hosted & private:** runs on your hardware with Docker. Voice generation runs on CPU by default with Kokoro (no GPU required). No cloud logins, no telemetry, and no subscriptions.
- **Personal RSS feed:** publishes episodes to your private podcast feed with chapters and transcripts, compatible with any podcast player, and optionally to Nostr.

---

## Installation

Install the orchestrator package from PyPI:

```bash
pip install vozonda
```

Or with `uv`:

```bash
uv add vozonda
```

### Optional Extras

- **Local Kokoro TTS (CPU-friendly):**
  ```bash
  pip install "vozonda[tts-kokoro]"
  ```
- **Local Piper TTS:**
  ```bash
  pip install "vozonda[tts-piper]"
  ```
- **Local Transcription (faster-whisper):**
  ```bash
  pip install "vozonda[stt]"
  ```
- **All TTS & STT extras:**
  ```bash
  pip install "vozonda[tts]"
  ```
- **Agent MCP server support:**
  ```bash
  pip install "vozonda[mcp]"
  ```

---

## Usage

Start the orchestrator API server:

```bash
vozonda
# or
vozonda-api
```

By default, the server listens on `http://127.0.0.1:8765`.

---

## Docker Quickstart

For full self-hosting with web UI and dependencies:

```bash
git clone https://github.com/Vozonda/vozonda.git
cd vozonda
docker compose up -d
```

Prebuilt multi-architecture containers are available from GitHub Container Registry:

```bash
docker pull ghcr.io/vozonda/vozonda:latest
```

---

## Links & Community

- **Website & Audio Samples:** [https://vozonda.com](https://vozonda.com)
- **GitHub Repository:** [https://github.com/Vozonda/vozonda](https://github.com/Vozonda/vozonda)
- **Bug Tracker:** [https://github.com/Vozonda/vozonda/issues](https://github.com/Vozonda/vozonda/issues)
- **License:** [MIT](https://github.com/Vozonda/vozonda/blob/main/LICENSE)
