PyDoctor
PyDoctor: A focused open-source choice for linked, static Python API documentation. Ranked #19 of 38 in Documentation Generators by our editors (7.4/10); pricing: Free plan; best for python projects needing linked API docs.
At a glance
- Editor score7.4 / 10
- PricingFree plan
- Best forPython projects needing linked API docs
- Free planYes
- Paid fromFree
- Source inputsPython modules, Python packages, C modules
- Facts checked20 Sep 2026

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
Our verdict on PyDoctor
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.
Your product? Our editors can test PyDoctor in depth and publish a review, labelled as paid · from $149/mo →
PyDoctor pricing
PyDoctor fact sheet
| Free plan | Yes |
|---|---|
| Paid from | Free |
| Source inputs | Python modules, Python packages, C modules |
| API reference generation | Yes |
| Versioned documentation | Not verified |
| CI/CD integration | Yes |
| Output formats | HTML, Intersphinx inventory |
| Programming languages | Python |
| Deployment | Self-hosted |
| Platforms | Windows, macOS, Linux |
| Support | Docs |
| Built for | Solo, Small business, Mid-market, Enterprise (editorial estimate) |
| Integrations | 4 integrations: GitHub Actions, Read the Docs, Sphinx, Intersphinx |
| Pricing | Free plan |
| Website | pydoctor.readthedocs.io |
| Facts checked | 20 Sep 2026 |
PyDoctor integrations
PyDoctor lists 4 integrations on its own site.
- GitHub Actions
- Read the Docs
- Sphinx
- Intersphinx
Alternatives to PyDoctor
- SphinxA broad, extensible choice for teams building technical documentation from source files.9.4
- MkDocsA free, open-source choice for building focused Markdown documentation sites.9.2
- DoxygenA free, open-source choice for generating multi-language API documentation locally.9.0
See all PyDoctor alternatives →
Used PyDoctor? Be the first to review it
The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used PyDoctor for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.
Write a reviewTwo minutes · verified accounts only · read by an editor before it appears
Featured on iTechGuides
PyDoctor is listed in our Documentation Generators directory. Add the badge to your site — it links back to this page.
<a href="https://www.itechguides.com/products/pydoctor/"><img src="https://www.itechguides.com/best/badge/pydoctor.svg" alt="Featured on iTechGuides" width="230" height="46"></a>
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
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 · How we research and update

