---
id: python-docs-theme
version: "2026.7"
license: PSF-2.0
license_treatment: permissive
maintenance: active
---

# python-docs-theme — The Sphinx theme for the CPython docs and related projects

License: permissive · Maintenance: active · Downloads: 207.1K/mo

## What it is and what it does

python-docs-theme is a Sphinx theme that replicates the appearance and structure of the official CPython documentation. It's designed for Python community projects that want to adopt the familiar look of python.org docs. The theme depends only on Sphinx and is straightforward to integrate—you install it via pip and set html_theme = 'python_docs_theme' in your Sphinx conf.py.

The package carries a notable social dimension: using it borrows credibility from the CPython core developers' long-established documentation standards. The maintainers explicitly note that adopting the theme means accepting some responsibility for maintaining the trust associated with that visual identity. The theme supports localization and offers configuration options for sidebars; a live preview is available on ReadTheDocs.

Use it for:

- Style your Python library or framework docs to match the official Python documentation look and feel.
- Create community-maintained Python documentation that inherits visual consistency with python.org.
- Build Sphinx-based docs for Python Enhancement Proposals (PEPs) or other CPython-adjacent projects.
- Localize Python documentation using the theme's built-in translation support.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Sphinx theme that applies the visual style and layout of the official Python documentation to your own Sphinx-based docs.

Yes, if you're building Sphinx docs for a Python project and want the official Python docs appearance. The theme is actively maintained, has no known vulnerabilities, and carries a permissive license. The only real consideration is the implicit social contract: adopting this theme signals alignment with Python community standards, which is appropriate for most Python projects but worth acknowledging intentionally.

## Install

pip install python-docs-theme
uv add python-docs-theme
poetry add python-docs-theme

## Installing python-docs-theme

Before you install: Low friction install with a single runtime dependency on Sphinx. Active maintenance, last release 18 days ago, and repository shows recent activity.

License in practice: Licensed under PSF-2.0 (permissive), allowing use in both open and closed projects with minimal restrictions.

Quickstart:

pip install python-docs-theme

# In conf.py:
html_theme = 'python_docs_theme'

Requires Python 3.12 or newer and Sphinx 7.3 or newer.

Verify before relying:

- Whether the theme's sidebar and layout options are fully documented beyond the basic conf.py configuration mentioned.
- How well the theme handles custom Sphinx extensions or non-standard markup.
- Whether adopting this theme's visual identity carries any implicit expectations from the Python community beyond the stated trust/credibility note.

## Package facts

- License: PSF-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 207.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sphinx theme python docs, cpython documentation theme, python official docs styling, sphinx theme for python projects, python documentation sphinx, sphinx-theme, documentation

[View on SkillFed](https://skillfed.io/packages/python-docs-theme) · [View on PyPI](https://pypi.org/project/python-docs-theme/)