Skip to content

Commit 3815018

Browse files
committed
Update readme with more details on the cli.
1 parent e2d4ad6 commit 3815018

File tree

2 files changed

+25
-4
lines changed

2 files changed

+25
-4
lines changed

.claude/settings.local.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"permissions": {
3+
"allow": [
4+
"Bash(UV_PROJECT_ENVIRONMENT=venv uv run pytest:*)"
5+
]
6+
}
7+
}

README.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,29 @@
11
# Talk Python CLI
22

3-
A command-line interface for accessing [Talk Python to Me](https://talkpython.fm) podcast episodes, guest information, and [Talk Python Training](https://training.talkpython.fm) courses. Built on the Talk Python [MCP server](https://talkpython.fm/api/mcp), it gives you structured access to the full Talk Python catalog from your terminal.
3+
[![PyPI version](https://badge.fury.io/py/talk-python-cli.svg)](https://pypi.org/project/talk-python-cli/)
4+
[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://www.python.org/downloads/)
5+
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
6+
7+
Unlock 500+ episodes of [Talk Python to Me](https://talkpython.fm), full transcripts, guest profiles, and 50+ [Talk Python Training](https://training.talkpython.fm) courses — all from your terminal. Search, browse, and pipe structured data into your scripts, AI agents, or automation workflows.
48

59
## Why use this?
610

711
- **Automation** — Query episode data, guest info, and course catalogs from scripts and pipelines.
8-
- **LLM & AI integration** — Pipe JSON output directly into AI agents, RAG systems, or chat workflows.
12+
- **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.
913
- **Quick lookups** — Search episodes, pull transcripts, and browse courses without leaving the terminal.
1014

1115
## Installation
1216

1317
Requires Python 3.12+.
1418

1519
```bash
16-
# With uv (recommended)
20+
# Try it instantly with uvx (no install needed)
21+
uvx --from talk-python-cli talkpython episodes recent
22+
23+
# Or install it permanently with uv
1724
uv tool install talk-python-cli
1825

19-
# With pip
26+
# Or with pip
2027
pip install talk-python-cli
2128
```
2229

@@ -113,6 +120,13 @@ talkpython episodes transcript 535 | your-rag-pipeline ingest
113120
| `--url <mcp-url>` | Override the MCP server URL (default: `https://talkpython.fm/api/mcp`) |
114121
| `--version`, `-V` | Show version |
115122

123+
## Part of the Talk Python ecosystem
124+
125+
Talk Python CLI is one way to tap into the data behind the [Talk Python to Me](https://talkpython.fm) podcast and [Talk Python Training](https://training.talkpython.fm) courses. It connects to the same public [MCP server](https://talkpython.fm/api/mcp) 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.
126+
127+
- [Talk Python to Me Podcast](https://talkpython.fm)
128+
- [Talk Python Training](https://training.talkpython.fm)
129+
116130
## License
117131

118132
MIT

0 commit comments

Comments
 (0)