PyDoctor review

Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026

PyDoctor is a standalone, open-source command-line API documentation generator for Python projects. It analyzes Python modules and packages, resolves imports and inheritance hierarchies, and produces static HTML documentation. Developers documenting Python libraries and applications can use it to create API references from Python modules, Python packages, or C modules, with support for Windows, macOS, and Linux.

Its strongest area is the depth of its Python API analysis. PyDoctor computes inheritance hierarchies, parses Epytext, reStructuredText, Google, NumPy, and plaintext docstrings, and can add source-code links to generated pages. Configurable themes and templates, privacy settings, summaries, member ordering, and output paths provide control over how the documentation is presented. Intersphinx inventory generation and external API linking extend references beyond the project itself, while search and cross-references support navigation across the generated documentation.

PyDoctor also fits documentation workflows that publish from continuous integration. Published integrations include GitHub Actions, Read the Docs, Sphinx, and Intersphinx, with documented workflows for GitHub Actions and Read the Docs. Its output is centered on static HTML and Intersphinx inventory rather than a hosted documentation workspace, so teams should expect a command-line publishing model. PyDoctor is a strong fit for Python teams that want linked API references, source links, and configurable static output. Teams seeking a hosted service or broader language coverage should choose an alternative designed around those requirements.

PyDoctor pros and cons

• Where it wins
  • Parses five documented docstring formats
  • Links source code and external APIs
  • Supports GitHub Actions and Read the Docs workflows
• Where it doesn't
  • Command-line tool rather than a hosted documentation service
  • Focused on Python projects and Python API references
  • Does not include AI-assisted features

PyDoctor fact sheet, pricing and score →

Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.

Last updated 7 Oct 2026 · How we research and update