Containerizes app, configures AI API keys, and centralizes app settings.

Author: laurentftech

.env.example

@@ -0,0 +1,8 @@
+# API Keys for Podcast Generator
+# Copy this file to .env and fill in your actual API keys
+
+# ElevenLabs API Key (get one at https://elevenlabs.io)
+ELEVENLABS_API_KEY=your_elevenlabs_api_key_here
+
+# Google Gemini API Key (get one at https://ai.google.dev)
+GEMINI_API_KEY=your_gemini_api_key_here

.gitignore

@@ -22,3 +22,6 @@ _version.py
 *.DS_Store
 Podcast_generator.egg-info/
 instance/*
+
+# Environment variables (contains API keys)
+.env

README.md

@@ -1,5 +1,7 @@
 # 🎙️ Podcast Generator
 [![Buy Me a Coffee](https://img.shields.io/badge/Buy_Me_a_Coffee-FFDD00?style=flat&logo=buy-me-a-coffee&logoColor=000000)](https://www.buymeacoffee.com/laurentftech)
+[![Docker Hub](https://img.shields.io/docker/v/gandulf78/podcast_generator?label=docker&logo=docker)](https://hub.docker.com/r/gandulf78/podcast_generator)
+[![Docker Pulls](https://img.shields.io/docker/pulls/gandulf78/podcast_generator)](https://hub.docker.com/r/gandulf78/podcast_generator)
 
 If you enjoy this project and want to support my work, feel free to [buy me a coffee](https://www.buymeacoffee.com/laurentftech) ☕. Thank you for your support!
 
@@ -235,6 +237,56 @@ pip install .[demo]
 
 ---
 
+## 🐳 Docker Deployment
+
+You can run Podcast Generator as a web service using Docker. This provides a REST API and web interface.
+
+### Setting up API Keys
+
+First, create a `.env` file with your API keys:
+
+```bash
+# Copy the example file
+cp .env.example .env
+
+# Edit .env and add your API keys
+# ELEVENLABS_API_KEY=your_actual_key_here
+# GEMINI_API_KEY=your_actual_key_here
+```
+
+### Using Docker Hub (Recommended)
+
+**Option 1: Using docker-compose (easiest)**
+
+```bash
+# Pull and start the container (reads .env automatically)
+docker-compose -f docker-compose.prod.yml up -d
+```
+
+**Option 2: Using docker run**
+
+```bash
+# Pull the latest image
+docker pull gandulf78/podcast_generator:latest
+
+# Run the container (load .env file)
+docker run -d -p 8000:8000 \
+  -v $(pwd)/config:/app/config \
+  -v $(pwd)/logs:/app/logs \
+  --env-file .env \
+  gandulf78/podcast_generator:latest
+```
+
+The web interface will be available at `http://localhost:8000`
+
+### Building from Source
+
+```bash
+docker-compose up --build
+```
+
+---
+
 ## 👨‍💻 For Developers
 To contribute to the project, run the code, or create your own build, please refer to the full developer guide:
 ➡️ [DEVELOPERS.md](docs/DEVELOPERS.md)

app.py

@@ -1,6 +1,7 @@
 from flask import Flask, render_template, request, jsonify, send_from_directory
 from generate_podcast import generate, PODCAST_SCRIPT, setup_logging, validate_speakers, update_elevenlabs_quota
-from utils import sanitize_text, get_asset_path
+from utils import sanitize_text, get_asset_path, get_app_data_dir
+from config import AVAILABLE_VOICES, DEFAULT_APP_SETTINGS
 from create_demo import create_html_demo_whisperx
 import os
 import tempfile
@@ -38,16 +39,14 @@
 
 
 def get_settings_path():
-    from gui import get_app_data_dir
     return os.path.join(get_app_data_dir(), "settings.json")
 
 def load_settings():
     try:
         with open(get_settings_path(), 'r') as f:
             return json.load(f)
     except (FileNotFoundError, json.JSONDecodeError):
-        from gui import PodcastGeneratorApp
-        return PodcastGeneratorApp.DEFAULT_APP_SETTINGS
+        return DEFAULT_APP_SETTINGS
 
 def save_settings(settings):
     with open(get_settings_path(), 'w') as f:
@@ -111,7 +110,7 @@ def update_settings():
 
 @app.route('/api/voices', methods=['GET'])
 def get_voices():
-    from gui import AVAILABLE_VOICES as gemini_voices
+    gemini_voices = AVAILABLE_VOICES
     elevenlabs_voices = []
     api_key = os.environ.get("ELEVENLABS_API_KEY")
     if api_key:

config.py

@@ -9,4 +9,49 @@
         "account": "gemini_api_key",
         "url": "https://aistudio.google.com/app/apikey"
     }
+}
+
+# Gemini available voices
+AVAILABLE_VOICES = {
+    "Zephyr": "Bright",
+    "Puck": "Upbeat",
+    "Charon": "Informative",
+    "Kore": "Firm",
+    "Fenrir": "Excitable",
+    "Leda": "Youthful",
+    "Orus": "Firm",
+    "Aoede": "Breezy",
+    "Callirrhoe": "Easy-going",
+    "Autonoe": "Bright",
+    "Enceladus": "Breathy",
+    "Iapetus": "Clear",
+    "Umbriel": "Easy-going",
+    "Algieba": "Smooth",
+    "Despina": "Smooth",
+    "Erinome": "Clear",
+    "Algenib": "Gravelly",
+    "Rasalgethi": "Informative",
+    "Laomedeia": "Upbeat",
+    "Achernar": "Soft",
+    "Alnilam": "Firm",
+    "Schedar": "Even",
+    "Gacrux": "Mature",
+    "Pulcherrima": "Forward",
+    "Achird": "Friendly",
+    "Zubenelgenubi": "Casual",
+    "Vindemiatrix": "Gentle",
+    "Sadachbia": "Lively",
+    "Sadaltager": "Knowledgeable",
+    "Sulafat": "Warm"
+}
+
+# Default application settings
+DEFAULT_APP_SETTINGS = {
+    "tts_provider": "elevenlabs",
+    "speaker_voices": {"John": "Schedar - Even", "Samantha": "Zephyr - Bright"},
+    "speaker_voices_elevenlabs": {
+        "John": {"id": "TX3LPaxmHKxFdv7VOQHJ", "display_name": "Liam - Male, Young, american"},
+        "Samantha": {"id": "cgSgspJ2msm6clMCkdW9", "display_name": "Jessica - Female, Young, american"}
+    },
+    "elevenlabs_quota_cache": None
 }

docker-compose.prod.yml

@@ -0,0 +1,14 @@
+services:
+  podcast-generator:
+    image: gandulf78/podcast_generator:latest
+    ports:
+      - "8000:8000"
+    volumes:
+      - ./config:/app/config
+      - ./logs:/app/logs
+    environment:
+      # These variables are loaded from the .env file
+      # Copy .env.example to .env and fill in your API keys
+      - ELEVENLABS_API_KEY=${ELEVENLABS_API_KEY}
+      - GEMINI_API_KEY=${GEMINI_API_KEY}
+    restart: always

docker-compose.yml

@@ -6,4 +6,7 @@ services:
     volumes:
       - ./config:/app/config
       - ./logs:/app/logs
+    environment:
+      - ELEVENLABS_API_KEY=${ELEVENLABS_API_KEY}
+      - GEMINI_API_KEY=${GEMINI_API_KEY}
     restart: always

gui.py

@@ -40,6 +40,7 @@
 from generate_podcast import validate_speakers, update_elevenlabs_quota
 from utils import get_asset_path, sanitize_app_settings_for_backend, find_ffplay_path, get_app_data_dir, sanitize_text
 from create_demo import create_html_demo_whisperx
+from config import AVAILABLE_VOICES, DEFAULT_APP_SETTINGS
 
 # --- Versioning ---
 # This file is automatically generated by setuptools-scm
@@ -49,55 +50,13 @@
     # Fallback développement: quand _version.py n'est pas encore généré
     __version__ = "0.0.0-dev"
 
-AVAILABLE_VOICES = {
-    "Zephyr": "Bright",
-    "Puck": "Upbeat",
-    "Charon": "Informative",
-    "Kore": "Firm",
-    "Fenrir": "Excitable",
-    "Leda": "Youthful",
-    "Orus": "Firm",
-    "Aoede": "Breezy",
-    "Callirrhoe": "Easy-going",
-    "Autonoe": "Bright",
-    "Enceladus": "Breathy",
-    "Iapetus": "Clear",
-    "Umbriel": "Easy-going",
-    "Algieba": "Smooth",
-    "Despina": "Smooth",
-    "Erinome": "Clear",
-    "Algenib": "Gravelly",
-    "Rasalgethi": "Informative",
-    "Laomedeia": "Upbeat",
-    "Achernar": "Soft",
-    "Alnilam": "Firm",
-    "Schedar": "Even",
-    "Gacrux": "Mature",
-    "Pulcherrima": "Forward",
-    "Achird": "Friendly",
-    "Zubenelgenubi": "Casual",
-    "Vindemiatrix": "Gentle",
-    "Sadachbia": "Lively",
-    "Sadaltager": "Knowledgeable",
-    "Sulafat": "Warm"
-}
-
 
 def get_app_version() -> str:
     """Gets the application version from the _version.py file."""
     return __version__
 
 
 class PodcastGeneratorApp:
-    DEFAULT_APP_SETTINGS = {
-        "tts_provider": "elevenlabs",
-        "speaker_voices": {"John": "Schedar - Even", "Samantha": "Zephyr - Bright"},
-        "speaker_voices_elevenlabs": {
-            "John": {"id": "TX3LPaxmHKxFdv7VOQHJ", "display_name": "Liam - Male, Young, american"},
-            "Samantha": {"id": "cgSgspJ2msm6clMCkdW9", "display_name": "Jessica - Female, Young, american"}
-        },
-        "elevenlabs_quota_cache": None
-    }
 
     def __init__(self, root: tk.Tk, generate_func, logger, api_key: str, default_script: str = ""):
         self.root = root
@@ -811,10 +770,10 @@ def load_settings(self):
                 settings = json.load(f)
                 # Load the settings as they are, preserving the rich dictionary for ElevenLabs.
                 # The data will be flattened only when needed (right before generation).
-                tts_provider = settings.get("tts_provider", self.DEFAULT_APP_SETTINGS["tts_provider"])
-                speaker_voices = settings.get("speaker_voices", self.DEFAULT_APP_SETTINGS["speaker_voices"].copy())
+                tts_provider = settings.get("tts_provider", DEFAULT_APP_SETTINGS["tts_provider"])
+                speaker_voices = settings.get("speaker_voices", DEFAULT_APP_SETTINGS["speaker_voices"].copy())
                 speaker_voices_elevenlabs = settings.get("speaker_voices_elevenlabs",
-                                                         self.DEFAULT_APP_SETTINGS["speaker_voices_elevenlabs"].copy())
+                                                         DEFAULT_APP_SETTINGS["speaker_voices_elevenlabs"].copy())
                 elevenlabs_quota_cache = settings.get("elevenlabs_quota_cache", None)
 
                 return {
@@ -825,7 +784,7 @@ def load_settings(self):
                 }
         except (FileNotFoundError, json.JSONDecodeError):
             # Returns default app settings if the file does not exist or is corrupt
-            return json.loads(json.dumps(self.DEFAULT_APP_SETTINGS))
+            return json.loads(json.dumps(DEFAULT_APP_SETTINGS))
 
     def save_settings(self, settings_to_save):
         """Saves the settings to the JSON file."""
@@ -934,7 +893,7 @@ def _show_settings_window(self):
             current_settings=self.app_settings,
             save_callback=self.save_settings,
             close_callback=self.on_settings_window_close,
-            default_settings=self.DEFAULT_APP_SETTINGS,
+            default_settings=DEFAULT_APP_SETTINGS,
             preloaded_elevenlabs_voices=self.elevenlabs_voices_cache,
             play_gemini_sample_callback=self.play_gemini_voice_sample,
             play_elevenlabs_sample_callback=self.play_elevenlabs_voice_sample