Skip to main content

Talk Python CLI

PyPI version Python 3.12+ License: MIT

Unlock 500+ episodes of Talk Python to Me, full transcripts, guest profiles, and 50+ Talk Python Training courses — all from your terminal. Search, browse, and pipe structured data into your scripts, AI agents, or automation workflows.

Why use this?

  • Automation — Query episode data, guest info, and course catalogs from scripts and pipelines.
  • LLM & AI integration — Pipe JSON or Markdown output directly into AI agents, RAG systems, or chat workflows. Feed transcripts into RAG pipelines, build podcast assistants, or enrich your AI tools with real Python community knowledge.
  • Quick lookups — Search episodes, pull transcripts, and browse courses without leaving the terminal.

Installation

Requires Python 3.12+.

# Install it permanently with uv
uv tool install talk-python-cli

# Or try it instantly with uvx (no install needed)
uvx --from talk-python-cli talkpython episodes recent

# Or with pip
pip install talk-python-cli

This installs the talkpython command.

Quick start

Copy this whole block and paste it into your terminal to see what you get.

# Search for episodes about FastAPI
talkpython episodes search "FastAPI"

# Get full details for a specific episode
talkpython episodes get 535

# Pull the transcript for an episode
talkpython episodes transcript 535

# List recent episodes
talkpython episodes recent --limit 5

# Search for a guest
talkpython guests search "Hynek"

# Browse all training courses
talkpython courses list

Commands

Episodes

Command Description
talkpython episodes search <query> [--limit N] Search episodes by keyword (default limit: 10)
talkpython episodes get <show_id> Get full details for an episode
talkpython episodes list List all episodes
talkpython episodes recent [--limit N] Get the most recent episodes
talkpython episodes transcript <show_id> Get the plain-text transcript
talkpython episodes transcript-vtt <show_id> Get the WebVTT transcript (with timestamps)

Guests

Command Description
talkpython guests search <query> [--limit N] Search guests by name
talkpython guests get <guest_id> Get details for a specific guest
talkpython guests list List all guests, sorted by number of appearances

Courses

Command Description
talkpython courses search <query> [--course_id N] Search courses, chapters, and lectures
talkpython courses get <course_id> Get full course details including chapters and lectures
talkpython courses list List all available training courses

Output formats

The CLI supports three output formats via --format:

  • text (default) — Rich-formatted Markdown with styled panels and color for human reading.
  • json — Structured JSON, pretty-printed on a TTY or compact when piped.
  • markdown — Raw Markdown output with no Rich formatting. Ideal for piping into AI agents, LLMs, and automation tools that consume Markdown natively.
# Force JSON output in the terminal
talkpython --format json episodes search "async"

# Raw Markdown for AI agents and LLM pipelines
talkpython --format markdown episodes get 535

# Force rich text output even when piping
talkpython --format text episodes recent | less -R

Agentic AI and LLM integration

Use --format markdown when feeding output to AI agents, LLMs, or RAG pipelines. This gives you clean, raw Markdown without terminal styling — exactly what language models expect:

# Feed an episode summary to an LLM
talkpython --format markdown episodes get 535 | llm "Summarize this podcast episode"

# Grab a transcript for RAG ingestion
talkpython --format markdown episodes transcript 535 | your-rag-pipeline ingest

# Pipe course details into an AI agent
talkpython --format markdown courses get 57 | your-agent process

Piping JSON to other tools

The --format json output integrates naturally with tools like jq or your own scripts:

# Extract episode titles with jq
talkpython --format json episodes search "testing" | jq '.title'

# Process structured data in a script
talkpython --format json episodes recent | python process_episodes.py

Global options

Option Description
--format text|json|markdown Output format: text (rich), json, or markdown (raw)
--url <mcp-url> Override the MCP server URL (default: https://talkpython.fm/api/mcp)
--version, -V Show version

Part of the Talk Python ecosystem

Talk Python CLI is one way to tap into the data behind the Talk Python to Me podcast and Talk Python Training courses. It connects to the same public MCP server that powers Talk Python's AI integrations — so whether you're building an agent, a search tool, or just want quick answers from the terminal, you're working with the real data.

License

MIT

Release files for talk-python-cli 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for talk-python-cli 0.2.0
File Size Uploaded
talk_python_cli-0.2.0.tar.gz 27.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for talk-python-cli 0.2.0
File Interpreter ABI Platform
talk_python_cli-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 39.6 kB

Release files / talk_python_cli-0.2.0.tar.gz

Download URL talk_python_cli-0.2.0.tar.gz
Size 27.6 kB
Tags Source
SHA-256 checksum
How to use checksums
99267dd8a0fb4346ca8e73e6e4d3738620601039bdbbe82dad07a50532997440
BLAKE2b-256 checksum
How to use checksums
8db64ce56fdc89f2a2a547997583ee4291df8df9952a0fa46cf7537b42558795
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / talk_python_cli-0.2.0-py3-none-any.whl

Download URL talk_python_cli-0.2.0-py3-none-any.whl
Size 11.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f3e616aa69de03214644978b7cefa187fe85122bf6d1d22ccf342122d9846ca5
BLAKE2b-256 checksum
How to use checksums
bf4f9b69c63fca7b9606f192eb425ead1b22ce30b8dbf64103cc7513b1170581
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page