cast2md 2025.1__tar.gz

cast2md-2025.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Linus Dennert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cast2md-2025.1/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: cast2md
+Version: 2025.1
+Summary: Podcast transcription service - download episodes via RSS and transcribe with Whisper
+Author: cast2md
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+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
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: feedparser>=6.0.0
+Requires-Dist: httpx[socks]>=0.26.0
+Requires-Dist: faster-whisper>=1.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: apscheduler>=3.10.0
+Requires-Dist: bleach>=6.0
+Requires-Dist: mcp[cli]>=1.2.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: psycopg2-binary>=2.9.0
+Requires-Dist: pgvector>=0.2.0
+Requires-Dist: runpod>=1.6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: mlx
+Requires-Dist: mlx-whisper>=0.4.0; extra == "mlx"
+Provides-Extra: node
+Requires-Dist: httpx[socks]>=0.26.0; extra == "node"
+Requires-Dist: faster-whisper>=1.0.0; extra == "node"
+Requires-Dist: pydantic-settings>=2.0.0; extra == "node"
+Requires-Dist: python-dotenv>=1.0.0; extra == "node"
+Requires-Dist: click>=8.1.0; extra == "node"
+Requires-Dist: fastapi>=0.109.0; extra == "node"
+Requires-Dist: uvicorn[standard]>=0.27.0; extra == "node"
+Requires-Dist: jinja2>=3.1.0; extra == "node"
+Provides-Extra: node-mlx
+Requires-Dist: mlx-whisper>=0.4.0; extra == "node-mlx"
+Dynamic: license-file
+
+# cast2md
+
+Podcast transcription service - download episodes via RSS and transcribe with Whisper. Automatically downloads publisher-provided transcripts when available (Podcasting 2.0) or fetches auto-generated transcripts from Pocket Casts.
+
+> **Note**: This is a personal project under active development. I'm sharing it in case others find it useful, but I'm not currently providing support or reviewing pull requests.
+
+## Features
+
+- **iTunes URL Support**: Add podcasts via Apple Podcasts URLs (automatically resolves to RSS)
+- **RSS Feed Management**: Add podcast feeds and automatically discover new episodes
+- **External Transcript Downloads**: Fetches transcripts from Podcasting 2.0 tags and Pocket Casts before falling back to Whisper
+- **Whisper Transcription**: Transcribe audio using faster-whisper or mlx-whisper
+- **Distributed Transcription**: Use remote machines (M4 Macs, GPU PCs) to transcribe in parallel
+- **Full-Text Search**: Search across episode metadata and transcripts
+- **Web Interface**: Manage feeds, view episodes, and monitor progress
+- **REST API**: Full API for integration with other tools
+- **MCP Server**: Claude integration via Model Context Protocol
+
+## Installation
+
+### Docker
+
+```bash
+git clone https://github.com/meltforce/cast2md.git
+cd cast2md
+docker compose up -d
+```
+
+### Manual Installation
+
+```bash
+# Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Clone and install
+git clone https://github.com/meltforce/cast2md.git
+cd cast2md
+uv sync --frozen
+
+# Configure
+cp .env.example .env
+# Edit .env with your settings
+
+# Initialize and run
+uv run cast2md init-db
+uv run cast2md serve
+```
+
+## Configuration
+
+Create a `.env` file:
+
+```env
+DATABASE_PATH=./data/cast2md.db
+STORAGE_PATH=./data/media
+TEMP_DOWNLOAD_PATH=./data/temp
+
+# Whisper settings
+WHISPER_MODEL=medium          # tiny, base, small, medium, large-v3
+WHISPER_DEVICE=cpu            # cpu or cuda
+WHISPER_COMPUTE_TYPE=int8     # int8, float16, float32
+```
+
+### Whisper Models
+
+| Model | Quality | Speed (CPU) | RAM |
+|-------|---------|-------------|-----|
+| tiny | Basic | ~10x realtime | 1 GB |
+| base | Good | ~5x realtime | 2 GB |
+| small | Very good | ~2x realtime | 3 GB |
+| medium | Excellent | ~1x realtime | 6 GB |
+| large-v3 | Best | ~0.3x realtime | 12 GB |
+
+## Usage
+
+### Web Interface
+
+Access at `http://localhost:8000`
+
+- **Feeds**: Add and manage podcast RSS feeds
+- **Episodes**: View episodes and transcription status
+- **Search**: Search across titles, descriptions, and transcripts
+- **Admin**: Monitor system health and processing queue
+
+### CLI
+
+```bash
+# Add a podcast (RSS or Apple Podcasts URL)
+cast2md add-feed "https://example.com/feed.xml"
+cast2md add-feed "https://podcasts.apple.com/us/podcast/example/id123456"
+
+# List and manage
+cast2md list-feeds
+cast2md list-episodes <feed_id>
+
+# Process episodes
+cast2md download <episode_id>
+cast2md transcribe <episode_id>
+cast2md process <episode_id>  # download + transcribe
+
+# Server
+cast2md serve --host 0.0.0.0 --port 8000
+
+# Backup/restore
+cast2md backup -o backup.sql
+cast2md restore backup.sql
+```
+
+### MCP Server (Claude Integration)
+
+```json
+{
+  "mcpServers": {
+    "podcasts": {
+      "command": "/path/to/cast2md",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Available tools: `search_transcripts`, `search_episodes`, `queue_episode`, `add_feed`, `refresh_feed`
+
+### Distributed Transcription
+
+Run transcription workers on remote machines:
+
+```bash
+# On remote machine (Mac with MLX, GPU PC)
+cast2md node register --server http://server:8000 --name "Worker Name"
+cast2md node start
+```
+
+See [Distributed Transcription Setup](docs/distributed-transcription-setup.md) for details.
+
+## API
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /api/feeds` | List feeds |
+| `POST /api/feeds` | Add feed |
+| `GET /api/episodes/{id}` | Episode details |
+| `GET /api/episodes/{id}/transcript` | Download transcript |
+| `POST /api/queue/episodes/{id}/process` | Queue download |
+| `POST /api/queue/episodes/{id}/transcribe` | Queue transcription |
+| `GET /api/queue/status` | Queue status |
+
+## Development
+
+```bash
+uv sync
+uv run cast2md serve --reload
+uv run pytest
+```
+
+## License
+
+MIT

cast2md-2025.1/README.md

@@ -0,0 +1,158 @@
+# cast2md
+
+Podcast transcription service - download episodes via RSS and transcribe with Whisper. Automatically downloads publisher-provided transcripts when available (Podcasting 2.0) or fetches auto-generated transcripts from Pocket Casts.
+
+> **Note**: This is a personal project under active development. I'm sharing it in case others find it useful, but I'm not currently providing support or reviewing pull requests.
+
+## Features
+
+- **iTunes URL Support**: Add podcasts via Apple Podcasts URLs (automatically resolves to RSS)
+- **RSS Feed Management**: Add podcast feeds and automatically discover new episodes
+- **External Transcript Downloads**: Fetches transcripts from Podcasting 2.0 tags and Pocket Casts before falling back to Whisper
+- **Whisper Transcription**: Transcribe audio using faster-whisper or mlx-whisper
+- **Distributed Transcription**: Use remote machines (M4 Macs, GPU PCs) to transcribe in parallel
+- **Full-Text Search**: Search across episode metadata and transcripts
+- **Web Interface**: Manage feeds, view episodes, and monitor progress
+- **REST API**: Full API for integration with other tools
+- **MCP Server**: Claude integration via Model Context Protocol
+
+## Installation
+
+### Docker
+
+```bash
+git clone https://github.com/meltforce/cast2md.git
+cd cast2md
+docker compose up -d
+```
+
+### Manual Installation
+
+```bash
+# Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Clone and install
+git clone https://github.com/meltforce/cast2md.git
+cd cast2md
+uv sync --frozen
+
+# Configure
+cp .env.example .env
+# Edit .env with your settings
+
+# Initialize and run
+uv run cast2md init-db
+uv run cast2md serve
+```
+
+## Configuration
+
+Create a `.env` file:
+
+```env
+DATABASE_PATH=./data/cast2md.db
+STORAGE_PATH=./data/media
+TEMP_DOWNLOAD_PATH=./data/temp
+
+# Whisper settings
+WHISPER_MODEL=medium          # tiny, base, small, medium, large-v3
+WHISPER_DEVICE=cpu            # cpu or cuda
+WHISPER_COMPUTE_TYPE=int8     # int8, float16, float32
+```
+
+### Whisper Models
+
+| Model | Quality | Speed (CPU) | RAM |
+|-------|---------|-------------|-----|
+| tiny | Basic | ~10x realtime | 1 GB |
+| base | Good | ~5x realtime | 2 GB |
+| small | Very good | ~2x realtime | 3 GB |
+| medium | Excellent | ~1x realtime | 6 GB |
+| large-v3 | Best | ~0.3x realtime | 12 GB |
+
+## Usage
+
+### Web Interface
+
+Access at `http://localhost:8000`
+
+- **Feeds**: Add and manage podcast RSS feeds
+- **Episodes**: View episodes and transcription status
+- **Search**: Search across titles, descriptions, and transcripts
+- **Admin**: Monitor system health and processing queue
+
+### CLI
+
+```bash
+# Add a podcast (RSS or Apple Podcasts URL)
+cast2md add-feed "https://example.com/feed.xml"
+cast2md add-feed "https://podcasts.apple.com/us/podcast/example/id123456"
+
+# List and manage
+cast2md list-feeds
+cast2md list-episodes <feed_id>
+
+# Process episodes
+cast2md download <episode_id>
+cast2md transcribe <episode_id>
+cast2md process <episode_id>  # download + transcribe
+
+# Server
+cast2md serve --host 0.0.0.0 --port 8000
+
+# Backup/restore
+cast2md backup -o backup.sql
+cast2md restore backup.sql
+```
+
+### MCP Server (Claude Integration)
+
+```json
+{
+  "mcpServers": {
+    "podcasts": {
+      "command": "/path/to/cast2md",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Available tools: `search_transcripts`, `search_episodes`, `queue_episode`, `add_feed`, `refresh_feed`
+
+### Distributed Transcription
+
+Run transcription workers on remote machines:
+
+```bash
+# On remote machine (Mac with MLX, GPU PC)
+cast2md node register --server http://server:8000 --name "Worker Name"
+cast2md node start
+```
+
+See [Distributed Transcription Setup](docs/distributed-transcription-setup.md) for details.
+
+## API
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /api/feeds` | List feeds |
+| `POST /api/feeds` | Add feed |
+| `GET /api/episodes/{id}` | Episode details |
+| `GET /api/episodes/{id}/transcript` | Download transcript |
+| `POST /api/queue/episodes/{id}/process` | Queue download |
+| `POST /api/queue/episodes/{id}/transcribe` | Queue transcription |
+| `GET /api/queue/status` | Queue status |
+
+## Development
+
+```bash
+uv sync
+uv run cast2md serve --reload
+uv run pytest
+```
+
+## License
+
+MIT

cast2md-2025.1/pyproject.toml

@@ -0,0 +1,92 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cast2md"
+version = "2025.01"
+description = "Podcast transcription service - download episodes via RSS and transcribe with Whisper"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [
+    {name = "cast2md"}
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "feedparser>=6.0.0",
+    "httpx[socks]>=0.26.0",
+    "faster-whisper>=1.0.0",
+    "pydantic-settings>=2.0.0",
+    "python-dotenv>=1.0.0",
+    "click>=8.1.0",
+    "fastapi>=0.109.0",
+    "uvicorn[standard]>=0.27.0",
+    "jinja2>=3.1.0",
+    "apscheduler>=3.10.0",
+    "bleach>=6.0",
+    "mcp[cli]>=1.2.0",
+    "sentence-transformers>=2.2.0",
+    "psycopg2-binary>=2.9.0",
+    "pgvector>=0.2.0",
+    "runpod>=1.6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.23.0",
+    "ruff>=0.1.0",
+]
+mlx = [
+    "mlx-whisper>=0.4.0",
+]
+# Minimal node-only installation (~80-120 MB vs ~600 MB full install)
+# Install with: pip install --no-deps cast2md && pip install cast2md[node]
+node = [
+    "httpx[socks]>=0.26.0",
+    "faster-whisper>=1.0.0",
+    "pydantic-settings>=2.0.0",
+    "python-dotenv>=1.0.0",
+    "click>=8.1.0",
+    "fastapi>=0.109.0",
+    "uvicorn[standard]>=0.27.0",
+    "jinja2>=3.1.0",
+]
+# Add MLX support for Apple Silicon nodes
+node-mlx = [
+    "mlx-whisper>=0.4.0",
+]
+
+[project.scripts]
+cast2md = "cast2md.cli:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+# Use CPU-only PyTorch (avoid downloading 2GB+ of CUDA dependencies)
+[[tool.uv.index]]
+name = "pytorch-cpu"
+url = "https://download.pytorch.org/whl/cpu"
+explicit = true
+
+[tool.uv.sources]
+torch = { index = "pytorch-cpu" }
+triton = { index = "pytorch-cpu" }

cast2md-2025.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cast2md-2025.1/src/cast2md/__init__.py

@@ -0,0 +1,5 @@
+"""cast2md - Podcast transcription service."""
+
+from importlib.metadata import version
+
+__version__ = version("cast2md")

cast2md-2025.1/src/cast2md/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running cast2md as a module."""
+
+from cast2md.cli import cli
+
+if __name__ == "__main__":
+    cli()

cast2md-2025.1/src/cast2md/api/__init__.py

@@ -0,0 +1 @@
+"""API module."""