No known security advisories.
The current version has no OSV.dev malware reports and no critical or high-severity vulnerabilities.
instructor has 16M monthly downloads and 13K GitHub stars. Version 1.15.4 supports Python <4.0,>=3.9, first published in 2017.
It is actively maintained under a permissive license, last released in Jun 2026.
It is built on top of aiohttp, docstring-parser and jinja2. It is used by 381 tracked packages, including crewai, ragas and postgres-mcp.
GitHub topics include openai, pydantic-v2 and openai-functions.
Package Insights
Score breakdown - each component scores 0-100, weighted by percentage
Maintenance
90
Popularity
87
Adoption
80
Community
70
Provenance
0
How the maintenance status was determined
Last commit
9 days ago
Monthly downloads
16,022,070
•
Active
Activity within 30 days
Stable
Activity within 31-180 days
Minimal
Activity within 181-365 days, or no activity data
At Risk
No activity for > 365 days, but > 10,000 monthly downloads
Archived
Repository flagged as archived on GitHub
How the popularity category was determined
Monthly downloads
16,022,070
Stars
13,390
Stars per 1k downloads
0.84
•
Industry Standard
> 10,000,000 monthly downloads
Hidden Gem
< 0.5 stars per 1k downloads and > 100,000 monthly downloads
Community Favorite
> 5 stars per 1k downloads
Rising Star
Balanced ratio of stars to downloads
Unknown
Fewer than 1,000 monthly downloads, or no star data
How download momentum is calculated
Week daily avg
541,306
Month daily avg
534,069
Momentum
+1.4%
((week_daily_avg - month_daily_avg) / month_daily_avg) * 100Python version support tiers
requires_python
<4.0,>=3.9
Cutting Edge
Minimum supported version is 3.12 or newer
•
Modern
Minimum supported version is 3.9, 3.10, or 3.11
Legacy
Supports 3.8 or older (or Python 2)
Unknown
No requires_python specified or unparseable
License categories
License
MIT
•
Permissive
MIT, Apache, BSD, ISC, Unlicense, CC0, etc.
Copyleft
GPL, LGPL, AGPL, MPL, EPL, etc.
Proprietary
Commercial, all rights reserved, custom EULAs
Unknown
No license specified, or none of the above match
How the release cadence was determined
Last release
10 days ago
Total releases
97
Releases/year
10.8
Rapid
Last release within 365 days and > 12 releases/year
•
Regular
Last release within 365 days
Slow
Last release 366-730 days ago
Stalled
Last release > 730 days ago, or no releases
Unknown
No usable release date available
How contributor risk was determined
Contributors
270
Monthly downloads
16,022,070
High Load
≤ 2 contributors and ≥ 50,000 monthly downloads
Moderate Load
< 10 contributors and ≥ 500,000 monthly downloads
Low Load
< 25 contributors and ≥ 5,000,000 monthly downloads, or sole maintainer with ≥ 10,000 monthly downloads
•
Balanced
Enough contributors for the package's popularity
Unknown
No contributor data available
Engagement
83
Issue Burden
1.0
per 1k stars
Discussions
12.0
per 1k stars
Fork Ratio
24.1%
contrib / forks
Stale Release
No
PR Velocity
Quiet
Weekly Downloads
GitHub Stars
Not all downloads include detailed metadata. Breakdowns reflect the subset that does.
Downloads by OS
Linux
396.3K
Windows
9.5K
macOS
6.7K
Python Versions
3.12
44.3%
181.4K
3.11
31.3%
128.1K
3.13
18.5%
75.8K
3.14
3.5%
14.4K
3.10
2.3%
9.5K
Top Countries
1.
US
246.5K
US
2.
SG
55.5K
SG
3.
DE
30.6K
DE
4.
IN
13.7K
IN
5.
IE
7.3K
IE
6.
GB
5.7K
GB
7.
BR
5.2K
BR
8.
JP
4.6K
JP
9.
FR
4.5K
FR
10.
KR
4.2K
KR
Dependencies
11
- aiohttp <4.0.0,>=3.9.1
- docstring-parser <1.0,>=0.16
- jinja2 <4.0.0,>=3.1.4
- jiter <0.15,>=0.6.1
- openai <3.0.0,>=2.0.0
- pydantic <3.0.0,>=2.8.0
- pydantic-core <3.0.0,>=2.18.0
- requests <3.0.0,>=2.32.3
- rich <15.0.0,>=13.7.0
- tenacity <10.0.0,>=8.2.3
- typer <1.0.0,>=0.9.0
53 optional dependencies
- anthropic[anthropic]
- anthropic[dev]
- boto3[bedrock]
- cerebras-cloud-sdk[cerebras-cloud-sdk]
- cohere[cohere]
- coverage[dev]
- datasets[datasets]
- diskcache[test-docs]
- diskcache[diskcache]
- fastapi[test-docs]
- fireworks-ai[fireworks-ai]
- google-cloud-aiplatform[vertexai]
- google-genai[google-genai]
- graphviz[graphviz]
- groq[groq]
- jsonref[dev]
- jsonref[google-genai]
- jsonref[vertexai]
- litellm[test-docs]
- litellm[litellm]
- mistralai[test-docs]
- mistralai[mistral]
- mkdocs[docs]
- mkdocs-jupyter[docs]
- mkdocs-llmstxt[docs]
- mkdocs-material[docs]
- mkdocs-material-extensions[docs]
- mkdocs-minify-plugin[docs]
- mkdocs-redirects[docs]
- mkdocs-rss-plugin[docs]
- mkdocstrings[docs]
- mkdocstrings-python[docs]
- openai[perplexity]
- pandas[test-docs]
- phonenumbers[phonenumbers]
- pre-commit[dev]
- pydantic-extra-types[test-docs]
- pydub[pydub]
- pytest[dev]
- pytest-asyncio[dev]
- pytest-examples[docs]
- pytest-examples[dev]
- pytest-xdist[dev]
- python-dotenv[dev]
- redis[test-docs]
- sqlmodel[sqlmodel]
- tabulate[test-docs]
- trafilatura[trafilatura]
- ty[dev]
- writer-sdk[writer]
- xai-sdk[xai]
- xmltodict[anthropic]
- xmltodict[dev]
Used By
381
- crewai
- ragas
- postgres-mcp
- cognee
- grading-notes
- agenthatch
- atomic-agents
- bespokelabs-curator
- keywordsai-tracing
- lumen
- superlinked
- opalacoder
- matryca-plumber
- calibrate-agent
- pipelex
- extract-thinker
- vibe-automation
- dsrag
- evidentia-ai
- coreason-runtime
- ciris-agent
- evalvault
- omnime
- perla-extract
- hotspot-research-cli
- agent-attest
- kura
- hands-on-ai
- bellek
- justai
- costly
- ct-toolkit
- omg-llmkit
- pywaai
- apropos-ai
- coarse-ink
- graded
- meta-evaluator
- folderbot
- plurally
- cognee-community-hybrid-adapter-falkor
- omniadapters
- cuery
- agentscope-bricks
- cognee-community-vector-adapter-qdrant
- smolmodels
- lilac
- cntext
- gpt-multi-atomic-agents
- opsmate
GitHub Topics
Tags from the package's GitHub repository describing what it does.
Package Information
License
MIT
First Release
July 30, 2017
Last Release
1 week ago
Last Commit
1 week ago
Latest Version
1.15.4
Total Releases
97
Contributors
270
Open PRs
29
Archived
No
Author
Jason Liu, Ivan Leo
Wheels
py3
Tracking Since
January 6, 2026
Data Updated
July 5, 2026
Data Freshness
Fresh