---
id: griffe
version: "2.1.0"
license: ISC
license_treatment: permissive
maintenance: active
---

# griffe — Signatures for entire Python programs. Extract the structure, the frame, the skeleton of your project, to generate API documentation or find breaking changes in your API.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install griffe
uv add griffe
poetry add griffe

## Description

# Griffe

[![ci](https://github.com/mkdocstrings/griffe/workflows/ci/badge.svg)](https://github.com/mkdocstrings/griffe/actions?query=workflow%3Aci)
[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://mkdocstrings.github.io/griffe/)
[![pypi version](https://img.shields.io/pypi/v/griffe.svg)](https://pypi.org/project/griffe/)
[![gitter](https://img.shields.io/badge/matrix-chat-4db798.svg?style=flat)](https://app.gitter.im/#/room/#mkdocstrings_griffe:gitter.im)
[![radicle](https://img.shields.io/badge/rad-clone-6666FF.svg?style=flat)](https://app.radicle.at/nodes/seed.radicle.at/rad:z4M5XTPDD4Wh1sm8iPCenF85J3z8Z)

<img src="https://raw.githubusercontent.com/mkdocstrings/griffe/main/logo.svg" alt="Griffe logo, created by François Rozet" width="200" align="right">

Signatures for entire Python programs. Extract the structure, the frame, the skeleton of your project, to generate API documentation or find breaking changes in your API.

Griffe, pronounced "grif" (`/ɡʁif/`), is a french word that means "claw",
but also "signature" in a familiar way. "On reconnaît bien là sa griffe."

- [User...

## AI interpretation — verify before relying

Griffe extracts the structure and signatures of Python programs to generate API documentation and detect breaking changes in your API.

Verdict: Griffe is a production-ready, actively maintained tool for Python API introspection and breaking-change detection. It installs cleanly with no friction, carries an ISC permissive license, and has no known vulnerabilities. Suitable for documentation generation pipelines and API compatibility testing.

[View on SkillFed](https://skillfed.io/packages/griffe) · [View on PyPI](https://pypi.org/project/griffe/)