mkdocstrings/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.
Star History
Momentum
+17
STARS · LAST 30 DAYS
1
PER DAY
#457
MOST-STARRED Python
| Window | 7 days | 30 days | 90 days |
|---|---|---|---|
| Stars gained | +7 | +17 | +90 |
| Per day | 1 | 1 | 1 |
| Forks gained | +1 | +3 | +10 |
griffe gained 17 stars in the last 30 days, about 1 a day, and now has 695. It is about 5 years old and has averaged roughly 139 stars a year. It ranks #457 among Python repositories and #3,668 across all languages on GitHubRepo.
Trending Record
1
DAYS ON TRENDING
#3680
BEST RANK
Sep 29, 2026
FIRST APPEARANCE
Active
STATUS TODAY
griffe has maintained a continuous presence across global trending indexes, peaking at #3680. Below is the 30-day activity profile:
💡 Overview
griffe is an open-source project written in Python: 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.
Engineered for speed, consistency, and developer ease, it solves common hurdles in api, breaking-changes, docs. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.
⚡ Key Features
Optimized execution pipeline written in Python for predictable speed.
Zero-friction configuration with comprehensive sensible defaults out of the box.
Cross-platform runtime support across Linux, macOS, and Windows environments.
Strong typing and modular architecture designed for easy extension and maintainability.
Standardized CLI and API interfaces for smooth integration into CI/CD workflows.
Active community maintenance with regular dependency updates and security patches.
📥 Installation
$ pip install griffe⚙ System Requirements
Platforms
- • macOS
- • Linux
- • Windows
Runtime & Dependencies
Python >= 3.9, pip, virtualenv
Architecture
x86_64, ARM64 (Apple Silicon & Graviton)
🧠 How It Works
griffe coordinates its core functionality through a modular Python pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.
🎯 Production Use Cases
Production System Integration
Embed griffe into Python backend services to handle core application logic.
CI/CD Automated Pipelines
Run automated validation, builds, and integration suites during deployments.
Developer Tooling & Workflows
Accelerate developer onboarding with pre-configured project utilities.
Open Source Extension
Fork and customize internal modules under the repository's open ISC license.
🚀 Getting Started
Install griffe using your package manager: `pip install griffe`
Initialize your project workspace or configuration file for griffe.
Import griffe into your codebase or invoke it directly from your terminal.
Execute your test suite or run `griffe --help` to verify successful setup.
👍 Strengths
⚠️ Considerations
⇄ Alternatives & Direct Competitors
👥 Who Should Use This
Developers and engineering teams building with Python, seeking reliable, tested, and actively maintained tooling for production workloads.
🏆 Nearby in the Rankings
mkdocstrings/griffe is currently ranked #3,668 by stars across every repository tracked on GitHubRepo. These are adjacent projects:
| Rank | Repository | Language | Stars | Action |
|---|---|---|---|---|
| #3,661 | evenfire-ai/evenfire | TypeScript | ★ 697 | Compare ↗ |
| #3,664 | macbre/analyze-css | JavaScript | ★ 696 | Compare ↗ |
| #3,664 | SwiftPackageIndex/SwiftPackageIndex-Server | Swift | ★ 696 | Compare ↗ |
| #3,664 | iandiv/AppGroup | C# | ★ 696 | Compare ↗ |
| #3,664 | TheDuffman85/crowdsec-web-ui | TypeScript | ★ 696 | Compare ↗ |
| #3,668 | mkdocstrings/griffe This Project | Python | ★ 695 | |
| #3,668 | eat-pray-ai/yutu | Go | ★ 695 | Compare ↗ |
| #3,668 | Leadaxe/singbox-launcher | Go | ★ 695 | Compare ↗ |
| #3,668 | paradigmxyz/iron-proxy | Go | ★ 695 | Compare ↗ |
| #3,672 | yoheimuta/protolint | Go | ★ 694 | Compare ↗ |
| #3,672 | bitwarden/ios | Swift | ★ 694 | Compare ↗ |
Frequently Asked Questions
What does griffe do? +
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.
What language is griffe written in? +
The primary language is Python. Topics include: api, breaking-changes, docs, mkdocstrings-collector, parser.
Is griffe actively maintained? +
Yes, the last recorded push was on Sep 29, 2026 with 39 open issues being tracked.
How many stars does griffe have? +
griffe has 695 stars and 75 forks on GitHub.
How does griffe rank among GitHub repositories? +
With 695 stars, mkdocstrings/griffe is ranked #3,668 globally across all repositories tracked on GitHubRepo and #457 among Python projects.
What license is griffe distributed under? +
The repository reports a ISC license. Always verify the repository LICENSE file for legal terms.
