peplum

Peplum is a terminal-based application for browsing and searching Python Enhancement Proposals (PEPs). It provides an interactive interface for exploring PEP metadata retrieved from the official PEP API, allowing developers to filter and search through the complete collection of Python enhancement proposals.

The application offers a full-featured terminal user interface with help screens accessible via F1 and comprehensive search capabilities across PEP content. Peplum locally caches PEP data and source files in XDG-compliant directories (~/.local/share/peplum/ and ~/.config/peplum/), storing metadata as JSON files and cached RST source files for offline access.

The tool is primarily useful for Python developers, language contributors, and anyone who frequently references PEPs during development. Rather than navigating the web-based PEP index, users can quickly search and browse proposals directly from the terminal, making it particularly valuable for developers working in terminal-heavy environments.

Installation

# via pipx
pipx install peplum

# via Homebrew
brew tap davep/homebrew && brew install peplum