Downstream projects¤

Griffe is used by various projects in the Python ecosystem. They are listed below in alphabetical order. Griffe extensions are listed on their own page.

api2mdx¤

api2mdx is a Python tool that generates mdx documentation for Python APIs. Under the hood, it uses Griffe.

Cybersecurity AI (CAI)¤

Cybersecurity AI (CAI) is a lightweight, open-source framework that empowers security professionals to build and deploy AI-powered offensive and defensive automation. It uses Griffe to parse docstrings in order to generate function schema for MCP tools. I believe it reused code from Pydantic AI.

Fumadocs¤

Fumadocs is a beautiful documentation framework for developers, flexible, performant, running on your React framework. It uses Griffe to extract and render Python API documentation.

griffe2md¤

griffe2md outputs API docs in Markdown. It uses Griffe to load the data, and then use Jinja templates to render documentation in Markdown, just like mkdocstrings-python, but in Markdown instead of HTML.

Griffe TUI¤

Griffe TUI is a textual user interface for Griffe. It offers 100% offline, beautiful Python API docs, in your terminal, thanks to Griffe and Textual.

Griffonner¤

Griffonner is a template-first Python documentation generator that gets out of your way. Griffonner uses Griffe to parse your Python code and Jinja2 templates to generate docs in any format you want.

Hippogriffe¤

Hippogriffe is a set of tweaks on top of the MkDocs + mkdocstrings-python + Griffe documentation stack. It adds source links to GitHub to each top-level class or function, pretty-formats type annotations, improves unions/generics display, and more. Hippogriffe is used as a MkDocs plugin.

mdxify¤

mdxify generates API documentation from Python modules with automatic navigation and source links. MDX is the default output and Markdown is also supported via --format md.

Mistral AI Python Client¤

The Python client of Mistral AI uses Griffe to parse docstrings of Python-written MCP tools.

mkdocstrings-python¤

Of course, Griffe is what powers the Python handler of mkdocstrings. mkdocstrings is a plugin for MkDocs that allows rendering API docs easily.

OpenAI Agents SDK¤

The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows. It was inspired by Pydantic AI and uses Griffe the same way, to parse docstrings in order to generate function schemas.

pydanclick¤

Pydanclick allows to use Pydantic models as Click options. It uses Griffe to parse docstrings and find Attributes sections, to help itself build Click options.

PydanticAI¤

PydanticAI is a Python Agent Framework designed to make it less painful to build production grade applications with Generative AI. It uses Griffe to extract tool and parameter descriptions from docstrings.

quartodoc¤

quartodoc lets you quickly generate Python package API reference documentation using Markdown and Quarto. quartodoc is designed as an alternative to Sphinx. It uses Griffe to load API data and parse docstrings in order to render HTML documentation, just like mkdocstrings-python, but for Quarto instead of Mkdocs.