Metadata-Version: 2.4
Name: local-ai-podcast-studio
Version: 0.1.0
Summary: Transform articles into natural podcast episodes using local TTS models
Author-email: Zach <zach@example.com>
License: MIT
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: fastapi>=0.109.0
Requires-Dist: markdown>=3.5.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: pypdf>=3.17.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: pyttsx3>=2.90
Requires-Dist: requests>=2.31.0
Requires-Dist: stripe>=7.0.0
Requires-Dist: tts>=0.22.0
Requires-Dist: uvicorn[standard]>=0.27.0
Provides-Extra: dev
Requires-Dist: httpx>=0.25.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# Local AI Podcast Studio

Transform articles, papers, and notes into natural-sounding podcast episodes—locally, privately, and without limits.

## What is this?

Local AI Podcast Studio converts written content into engaging multi-voice podcast episodes using local text-to-speech models. Drag and drop a URL, PDF, or Markdown file, and get back a finished podcast with realistic dialogue, ad-libbed transitions, and chapter markers—all processed on your machine with zero cloud dependencies or subscription fees.

## Features

- **Local-first processing** – No cloud APIs, no data upload, no usage limits
- **Multi-voice conversations** – Automatic dialogue generation with distinct speaker personalities
- **Content extraction** – Direct URL support plus PDF and Markdown file parsing
- **Realistic audio** – Distilled TTS models deliver natural-sounding speech with contextual pausing
- **Smart structuring** – Chapter markers, transitions, and pacing optimized for listening
- **Privacy by design** – All inference runs on your hardware
- **One-time purchase** – $29 perpetual license, no subscriptions

## Quick Start

### Installation

Clone the repository and install dependencies:

```bash
git clone https://github.com/yourusername/local-ai-podcast-studio.git
cd local-ai-podcast-studio
pip install -e .
```

### Usage

**Via CLI:**

```bash
podcast-studio --input article.pdf --output podcast.mp3
podcast-studio --url https://example.com/article --voice clara,james
```

**Via API:**

```python
from podcast_studio import PodcastStudio

studio = PodcastStudio()
podcast = studio.create(
    source="https://example.com/article",
    voices=["clara", "james"],
    output_path="podcast.mp3"
)
```

**Via Desktop App:**

1. Launch the application
2. Drag and drop a URL, PDF, or Markdown file
3. Select voices and customize settings
4. Click "Generate Podcast"
5. Download your MP3

## Tech Stack

- **Language**: Python 3.10+
- **TTS Engine**: Local distilled models (Needle 26M or similar)
- **Content Extraction**: BeautifulSoup, PyPDF2, Markdown parser
- **API Framework**: FastAPI
- **Desktop UI**: PyQt6 (or Electron for cross-platform)
- **Audio Processing**: librosa, pydub
- **Testing**: pytest, unittest
- **CI/CD**: GitHub Actions

## Architecture

```
podcast_studio/
├── extractor.py      # URL/PDF/Markdown parsing
├── scripter.py       # Dialogue generation & structuring
├── synthesizer.py    # TTS and audio composition
├── api.py           # REST API endpoints
├── cli.py           # Command-line interface
├── main.py          # Desktop application
└── config.py        # Configuration management
```

## License

MIT