Post

Ai Podcast Generator

Python application Docker support Docker Pulls Docker Image Size Check it out on Twitter License

AI Podcast Generator 🎙️

An AI-powered tool that transforms YouTube videos into engaging podcast discussions. Features a modern web interface for easy use and optional CLI functionality. Downloads videos, transcribes them, and generates natural conversations between AI voices discussing the content.

https://github.com/user-attachments/assets/daeb1068-6f63-499c-9790-8ac34a46a140

Features

  • 🎯 Modern web interface for easy podcast generation
  • 🎥 Embedded YouTube video player
  • 🔊 Interactive audio player for generated podcasts
  • 💾 History tracking of processed videos
  • 🤖 Natural conversation generation using Claude AI or XAI
  • 🗣️ Multiple AI voices using ElevenLabs
  • ⚡ Real-time processing status updates
  • 📝 Optional fact-checking of content

Quick Start with Docker Run 🐳

  • Install Docker.
  • Place your .env file in the same directory as this command. See the .env.example for details

Run the following command:

1
2
3
4
5
6
7
8
9
10
11
12
docker run -d --name podcast-app \
  --env-file .env \
  -p 5000:5000 \
  -p 5173:5173 \
  -v $(pwd)/public/audio:/app/public/audio \
  -v $(pwd)/output:/app/output \
  --restart unless-stopped \
  --health-cmd="curl -f http://localhost:5000/health || exit 1" \
  --health-interval=30s \
  --health-timeout=10s \
  --health-retries=3 \
  bigsk1/podcast-ai:latest

Prerequisites

  • Node.js 18 +
  • Python 3.10 +
  • FFmpeg installed and in PATH
  • ElevenLabs API key
  • Anthropic (Claude) or XAI API key

Docker Compose Setup 🐳

You can run the application using Docker with these simple steps:

  1. Clone the repository and navigate to it:
1
2
git clone https://github.com/bigsk1/podcast-ai.git
cd podcast-ai
  1. Create your .env file with required API keys and settings, see the .env.example

  2. Using Docker Compose:

1
2
cd docker
docker-compose up -d --build

The application will be available at:

  • Frontend UI: http://localhost:5173

To stop the container:

1
docker-compose down

Note: Generated audio files will be available in the public/audio directory, just like in the standard setup.

Docker with Cuda for faster transcription on Nvidia GPU

Note: This is only slightly faster as the transcription can go pretty quick anyway on cpu. To use make sure you have nvidia container toolkit and cudnn installed on host machine.

  • Test to see if you can run by first using
1
sudo docker run --rm --runtime=nvidia --gpus all ubuntu nvidia-smi
  • Run docker compose with cuda enabled transcription
    1
    
    docker compose -f cuda.docker-compose.yml up -d --build
    

Installation - Windows / Ubuntu

  1. Clone the repository:
    1
    2
    
    git clone https://github.com/bigsk1/podcast-ai.git
    cd podcast-ai
    
  2. Install frontend dependencies:
    1
    
    npm install
    
  3. Set up Python environment and install dependencies:
1
2
3
4
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate     # Windows

Install requirements

1
pip install -r requirements.txt
  1. Create .env file with your API keys:
# ELEVENLABS VOICE ID'S - add your own voice id's 
VOICE1=111111111111
VOICE2=111111111111

# AI Model Settings - xai, anthropic
AI_PROVIDER=anthropic

# model name: grok-beta, claude-3-5-sonnet-latest
MODEL_NAME=claude-3-5-sonnet-latest

# Podcast Generation Settings
# Minimum number of back-and-forth exchanges
MIN_EXCHANGES=4
# Maximum number of exchanges
MAX_EXCHANGES=20
# Minimum words per exchange
EXCHANGE_LENGTH_MIN_WORDS=20
# Maximum words per exchange
EXCHANGE_LENGTH_MAX_WORDS=150

# Audio Length Control
# Target length for final podcast (in minutes)
TARGET_LENGTH_MINUTES=3
# Allowed deviation from target (20% = ±36 seconds for 3 min target)
LENGTH_FLEXIBILITY=0.2
# Target output length as ratio of source (0.2 = 20% of original)
SOURCE_LENGTH_RATIO=0.2
# Minimum podcast length in minutes
MIN_PODCAST_LENGTH=2
# Minimum podcast length in minutes
MAX_PODCAST_LENGTH=5
# Maximum podcast length in minutes

# Content Coverage
# comprehensive, summary, or highlights, humor, emotional, debate
COVERAGE_STYLE=highlights
# Enable AI fact checking
FACT_CHECK_ENABLED=false
# balanced, critical, or supportive
FACT_CHECK_STYLE=balanced          

# Model Settings
TEMPERATURE=0.7
MAX_TOKENS=8192

LOGGING_LEVEL=DEBUG

# Output Directory
OUTPUT_DIR=output

# ANTHROPIC API KEY
ANTHROPIC_API_KEY=your_key_here

# ELEVENLABS API KEY
ELEVENLABS_API_KEY=your_key_here

# For XAI
XAI_BASE_URL=https://api.x.ai
XAI_API_KEY=your_xai_key

# Frontend configuration
# if access on other machine on network change to actual server ip
VITE_API_URL=http://localhost:5000   
  1. Change voice.json.example to voice.json and add your voice names and id’s from elevenlabs, this is a collection that you want to use, set the current voice id in the .env when running the app.

  2. Make sure you have ffmpeg installed

Windows

1
winget install ffmpeg

Linux

1
sudo apt install ffmpeg

Usage

Web Interface

  1. Start the backend server in one terminal:
    1
    
    python api.py
    
  2. Start the frontend development server in another terminal:
    1
    
    npm run dev
    
  3. Open http://localhost:5173 in your browser

  4. Paste a YouTube URL and click “Generate AI Podcast Review”

CLI Version (Optional)

The tool can also be used from the command line:

1
2
3
4
5
6
7
8
9
10
11
# Basic usage
python main.py "https://www.youtube.com/watch?v=video_id"

# Skip audio generation
python main.py --no-audio "https://www.youtube.com/watch?v=video_id"

# Generate without merging
python main.py --no-merge "https://www.youtube.com/watch?v=video_id"

# Merge audio files manually
python merge_audio_cli.py output conversation.mp3

Output

Generated files are saved in:

  • UI version: public/audio/ directory
  • CLI version: output/ directory

Configuration Options

All configuration options are set through the .env file. See the sample .env file above for common settings. Also make sure you have your elevenlabs voice id’s. The provided example voice id’s in voices.json won’t work for you, each account has it’s own specific id’s to match there api key.

Examples

Check out the video on X.

https://aicodelabs.io/emotional.mp3


https://aicodelabs.io/silo.mp3


https://aicodelabs.io/merged.mp3

In Progress

  1. Adding Openai
  2. Adding ollama
  3. Add web search into fact checking of podcast
  4. Add youtube API and add a search feature in header and seperate page for one click podcast generation

Troubleshooting

Could not locate cudnn_ops64_9.dll

1
2
Could not locate cudnn_ops64_9.dll. Please make sure it is in your library path!
Invalid handle. Cannot load symbol cudnnCreateTensorDescriptor

To resolve this:

Install cuDNN: Download cuDNN from the NVIDIA cuDNN page https://developer.nvidia.com/cudnn

Here’s how to add it to the PATH:

Open System Environment Variables:

Press Win + R, type sysdm.cpl, and hit Enter. Go to the Advanced tab, and click on Environment Variables. Edit the System PATH Variable:

In the System variables section, find the Path variable, select it, and click Edit. Click New and add the path to the bin directory where cudnn_ops64_9.dll is located. Based on your setup, you would add:

1
C:\Program Files\NVIDIA\CUDNN\v9.5\bin\12.6

Apply and Restart:

Click OK to close all dialog boxes, then restart your terminal (or any running applications) to apply the changes. Verify the Change:

Open a new terminal and run

1
where cudnn_ops64_9.dll

pyaudio codec issue

Make sure you have ffmpeg installed and added to PATH on windows terminal ( winget install ffmpeg )

Github

Podcast-AI Github

This post is licensed under CC BY 4.0 by the author.