File size: 2,016 Bytes
5b248a4
 
30830c4
 
 
 
 
 
 
5b248a4
30830c4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5b248a4
30830c4
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
---
license: mit
title: πŸŽ™οΈ PodXplain
sdk: gradio
emoji: πŸ“š
colorFrom: red
colorTo: blue
pinned: true
short_description: PodXplain is a Hugging Face-hosted application that converts
---
# πŸŽ™οΈ PodXplain

**From script to story β€” voice it like never before.**

PodXplain is a Hugging Face-hosted application that converts long-form text into engaging multi-speaker podcast-style audio. Simply input your script, and get a professional-sounding MP3 podcast with automatic speaker detection and assignment.

## ✨ Features

- **πŸ“ Long-form Support**: Handle up to 50,000 characters of text
- **🎭 Multi-speaker Audio**: Automatic speaker detection and assignment
- **πŸ”„ Smart Segmentation**: Intelligent text splitting with progress tracking
- **🎡 High-quality Output**: MP3 format for optimal file size and compatibility
- **πŸš€ Real-time Progress**: Live updates during generation
- **🎨 Modern UI**: Clean, intuitive Gradio interface

## πŸ› οΈ Tech Stack

- **Frontend**: Gradio for interactive web interface
- **TTS Engine**: Nari DIA 1.6B for natural voice synthesis (currently mocked)
- **Audio Processing**: pydub for audio manipulation and MP3 conversion
- **Hosting**: Hugging Face Spaces with GPU support

## πŸ“‹ How to Use

1.  **Input Text**: Paste or type your podcast script (up to 50,000 characters)
2.  **Choose Mode**: Select speaker detection mode:
    * **Auto**: Smart detection based on content structure
    * **Paragraph**: Speaker changes at paragraph breaks
    * **Dialogue**: Detection based on dialogue markers
3.  **Generate**: Click "Generate Podcast" and watch the progress
4.  **Download**: Get your MP3 file and listen to your podcast!

## πŸš€ Quick Start

### Local Development

```bash
# Clone the repository
git clone [https://github.com/yourusername/podxplain.git](https://github.com/yourusername/podxplain.git) # Replace with your actual repo URL
cd podxplain

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py