Public recordGood
Software health reportschema 0.12.0 · metrics 1.13.0 · 2026-07-18 13:38 UTC
instructor-ai / instructor
structured outputs for llms
instructor-ai/instructor holds a health index of 77 out of 100, placing it in the Good band. It scores highest on Vitality (93/100) and lowest on Security (51/100). It was last updated 5 days ago. A single contributor accounts for most of its recent work.
77
overall / 100Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
77
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
Ownership
567-labsOrganization
130 followers4 public repossince Dec 2023
This repository is backed by an organization — shared, accountable stewardship that can outlive any single maintainer.
Package ecosystems
| Registry | Package | Version | Downloads / mo | Versions | Last publish |
|---|---|---|---|---|---|
| PyPI | instructor | 1.15.4 | - | 96 | 20 days ago |
Metrics by category
Vitality
Is the project alive — is code being written and are releases shipping?
93
Development activity
89Excellent
How it's scored
| 36/36 | Push recency — last push 5 days ago |
| 24.9/36 | Commit cadence — 36/52 weeks with commits |
| 18/18 | Commit volume — 237 commits in the last year |
| 10/10 | OpenSSF Scorecard: Maintained — 14 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10 |
Inputs used
| commits_last_year | 237 |
| human_commit_share | — |
| days_since_last_push | 5 |
| active_weeks_last_year | 36 |
Release discipline
100Excellent
How it's scored
| 27/27 | Ships releases — 100 releases published |
| 36/36 | Release recency — latest release 20 days ago |
| 27/27 | Release cadence — a release every ~19 days |
| 0/10 | OpenSSF Scorecard: Signed-Releases — no data |
Inputs used
| releases_count | 100 |
| latest_release_tag | v1.15.4 |
| releases_from_tags | no |
| days_since_latest_release | 20 |
| mean_days_between_releases | 19 |
Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.
Community & Adoption
Does the project have users, downloads, attention, and a welcoming setup for contributors?
83
Popularity & adoption
94Excellent
How it's scored
| 60/60 | Stars — 13,554 stars |
| 25/25 | Forks — 1,157 forks |
| 9.5/15 | Watchers — 53 watchers |
Inputs used
| forks | 1,157 |
| stars | 13,554 |
| watchers | 53 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Community health
70Good
How it's scored
| 22.5/22.5 | README |
| 22.5/22.5 | License — recognized license (MIT) |
| 18/18 | CONTRIBUTING guide |
| 0/13.5 | Code of conduct |
| 0/7.2 | Issue template |
| 0/6.3 | PR template |
Inputs used
| has_readme | yes |
| has_license | yes |
| has_contributing | yes |
| has_issue_template | no |
| has_code_of_conduct | no |
| has_pull_request_template | no |
Sustainability & Governance
Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?
64
Maintainer resilience (bus factor)
40At risk
How it's scored
| 9/54 | Bus factor — 1 contributor(s) cover half of all commits |
| 7.4/22.5 | Commit distribution — top contributor authored 67% of commits |
| 13.5/13.5 | Contributor breadth — 100 contributors |
| 10/10 | OpenSSF Scorecard: Contributors — project has 5 contributing companies or organizations |
Inputs used
| bus_factor | 1 |
| contributors_sampled | 100 |
| top_contributor_share | 0.67 |
How it's scored
| 45.3/46.8 | Issue resolution — 97% of issues closed |
| 20.7/38.3 | PR acceptance — 841/1,554 decided PRs merged |
| 4.5/15 | OpenSSF Scorecard: Code-Review — Found 10/28 approved changesets -- score normalized to 3 |
Inputs used
| merged_prs | 841 |
| open_issues | 21 |
| closed_issues | 651 |
| issue_closed_ratio | 0.969 |
| closed_unmerged_prs | 713 |
Ownership & stewardship
56Moderate
How it's scored
| 30/30 | Ownership backing — organization-owned |
| 0/20 | Verified domain |
| 15.2/25 | Owner reach — 130 followers of 567-labs |
| 10.3/25 | Track record — 4 public repos, account ~2 yr old |
Inputs used
| followers | 130 |
| owner_type | Organization |
| is_verified | — |
| owner_login | 567-labs |
| public_repos | 4 |
| account_age_days | 959 |
Package maintenance
100Excellent
How it's scored
| 25/25 | Published & resolvable — 1 package(s) on pypi |
| 35/35 | Publish recency — latest publish 20 days ago |
| 20/20 | Version history — 96 published versions |
| 20/20 | Not deprecated — active, not deprecated or yanked |
Inputs used
| packages | instructor |
| ecosystems | pypi |
| any_deprecated | no |
| min_days_since_publish | 20 |
Engineering Quality
Are baseline engineering and documentation practices in place?
92
Engineering practices
86Excellent
How it's scored
| 24/24 | CI workflows — 10 workflow(s) |
| 24/24 | Tests present |
| 16/16 | Linter config — .ruff.toml |
| 9.6/9.6 | Pre-commit hooks |
| 0/6.4 | .editorconfig |
| 12/20 | OpenSSF Scorecard: CI-Tests — 17 out of 25 merged PRs checked by a CI test -- score normalized to 6 |
Inputs used
| has_ci | yes |
| has_tests | yes |
| has_editorconfig | no |
| has_linter_config | yes |
| has_precommit_config | yes |
Documentation
100Excellent
How it's scored
| 30/30 | README |
| 25/25 | Documentation directory |
| 15/15 | Documentation / homepage site — https://python.useinstructor.com/ |
| 10/10 | Repository description |
| 10/10 | Topics — 6 topics |
| 10/10 | Wiki |
Inputs used
| topics | openai, python, pydantic-v2, openai-functions, validation, openai-function-calli |
| has_wiki | yes |
| homepage | https://python.useinstructor.com/ |
| has_readme | yes |
| has_docs_dir | yes |
| has_description | yes |
Security
Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?
51
Security posture
51Moderate
How it's scored
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — no data |
| 1.5/2.5 | CI-Tests — 17 out of 25 merged PRs checked by a CI test -- score normalized to 6 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 2.2/7.5 | Code-Review — Found 10/28 approved changesets -- score normalized to 3 |
| 2.5/2.5 | Contributors — project has 5 contributing companies or organizations |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 7.5/7.5 | Dependency-Update-Tool — update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | License — license file detected |
| 7.5/7.5 | Maintained — 14 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10 |
| 0/5 | Packaging — no data |
| 2.5/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 5 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 0/5 | Security-Policy — security policy file not detected |
| 0/7.5 | Signed-Releases — no data |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 124 existing vulnerabilities detected |
Inputs used
| source | openssf_scorecard |
| checks_evaluated | 15 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 3 |
| scorecard_aggregate | 5.1 |
Excluded from scoring (no data or not applicable): branch_protection, packaging, signed_releases. Remaining weights renormalized.
AI Readiness
How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.
77
Agent context & guidance
100Excellent
How it's scored
| 45/45 | Agent instructions — .cursor/rules/documentation-sync.mdc, .cursor/rules/followups.mdc, .cursor/rules/new-features-planning.mdc, .cursor/rules/readme.md, .cursor/rules/simple-language.mdc, AGENT.md, CLAUDE.md, docs/AGENT.md |
| 15/15 | Machine-readable docs (llms.txt) — llms.txt present |
| 0/40 | Legible commit history — no data |
Inputs used
| has_llms_txt | yes |
| legible_history_share | — |
| agent_instruction_files | .cursor/rules/documentation-sync.mdc, .cursor/rules/followups.mdc, .cursor/rules/new-features-planning.mdc, .cursor/rules/readme.md, .cursor/rules/simple-language.mdc, AGENT.md, CLAUDE.md, docs/AGENT.md |
| agent_instruction_max_bytes | 13,329 |
Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.
How it's scored
| 0/18 | One-command bootstrap |
| 22/22 | Automated tests |
| 11/11 | Lint / format config — .ruff.toml |
| 11/11 | Static type checking — instructor/py.typed |
| 10/10 | Reproducible environment — Dockerfile, lockfile |
| 0/10 | Demonstrated agent practice — no data |
| 5/8 | Automated maintenance — dependency automation configured, none observed in the sampled commits |
| 5/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 5 |
Inputs used
| has_nix | no |
| has_tests | yes |
| lockfiles | uv.lock |
| has_dockerfile | yes |
| typed_language | no |
| bootstrap_files | — |
| has_devcontainer | no |
| has_linter_config | yes |
| typecheck_configs | instructor/py.typed |
| agent_commit_share | — |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
Excluded from scoring (no data or not applicable): Demonstrated agent practice. Remaining weights renormalized.
How it's scored
| 27/45 | Type-checkable code — Python with type-check config (instructor/py.typed) |
| 55/55 | Manageable file sizes — 0/542 source files over 60KB |
Inputs used
| primary_language | Python |
| largest_source_bytes | 48,861 |
| source_files_sampled | 542 |
| oversized_source_files | 0 |
Machine-readable interfaces
40At risk
How it's scored
| 0/40 | API schema (OpenAPI/GraphQL/proto) |
| 0/20 | MCP server |
| 40/40 | Runnable examples — examples, notebooks |
Inputs used
| example_dirs | examples, notebooks |
| has_mcp_signal | no |
| api_schema_files | — |
Key facts
13,554GitHub stars
100contributors
237commits, last 12 months
5days since last push
100releases
1bus factor
21open issues
PyPIpackage ecosystems
More detail
OpenSSF Scorecard 5.1 / 10
5.1aggregate
Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).
| 10 | Binary-Artifacts | no binaries found in the repo |
| n/a | Branch-Protection | internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md |
| 6 | CI-Tests | 17 out of 25 merged PRs checked by a CI test -- score normalized to 6 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 3 | Code-Review | Found 10/28 approved changesets -- score normalized to 3 |
| 10 | Contributors | project has 5 contributing companies or organizations |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 10 | Dependency-Update-Tool | update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 14 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10 |
| n/a | Packaging | packaging workflow not detected |
| 5 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 5 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 0 | Security-Policy | security policy file not detected |
| n/a | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 124 existing vulnerabilities detected |
Direct dependencies 12
| Registry | Package | Version constraint | Manifest |
|---|---|---|---|
| PyPI | openai | >=2.0.0,<3.0.0 | pyproject.toml |
| PyPI | pydantic | <3.0.0,>=2.8.0 | pyproject.toml |
| PyPI | eval-type-backport | >=0.2.2 | pyproject.toml |
| PyPI | docstring-parser | <1.0,>=0.16 | pyproject.toml |
| PyPI | typer | <1.0.0,>=0.9.0 | pyproject.toml |
| PyPI | rich | <15.0.0,>=13.7.0 | pyproject.toml |
| PyPI | aiohttp | <4.0.0,>=3.9.1 | pyproject.toml |
| PyPI | tenacity | <10.0.0,>=8.2.3 | pyproject.toml |
| PyPI | pydantic-core | <3.0.0,>=2.18.0 | pyproject.toml |
| PyPI | jiter | >=0.6.1,<0.15 | pyproject.toml |
| PyPI | jinja2 | <4.0.0,>=3.1.4 | pyproject.toml |
| PyPI | requests | <3.0.0,>=2.32.3 | pyproject.toml |
All dependencies 301
Full resolved dependency set from the GitHub dependency graph: 27 direct and 274 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.
| Registry | Package | Version | Relation |
|---|---|---|---|
| PyPI | aiohttp | — | direct |
| PyPI | aiohttp | 3.12.15 | direct |
| PyPI | aiohttp | 3.13.5 | direct |
| PyPI | docstring-parser | — | direct |
| PyPI | docstring-parser | 0.17.0 | direct |
| PyPI | eval-type-backport | 0.2.2 | direct |
| PyPI | jinja2 | 3.1.6 | direct |
| PyPI | jiter | 0.10.0 | direct |
| PyPI | jiter | 0.14.0 | direct |
| PyPI | openai | — | direct |
| PyPI | openai | 1.24.1 | direct |
| PyPI | openai | 2.31.0 | direct |
| PyPI | openai | 2.6.0 | direct |
| PyPI | pydantic | — | direct |
| PyPI | pydantic | 2.11.7 | direct |
| PyPI | pydantic | 2.12.5 | direct |
| PyPI | pydantic | 2.7.1 | direct |
| PyPI | pydantic-core | 2.33.2 | direct |
| PyPI | pydantic-core | 2.41.5 | direct |
| PyPI | requests | 2.32.5 | direct |
| PyPI | rich | — | direct |
| PyPI | rich | 14.1.0 | direct |
| PyPI | rich | 14.3.3 | direct |
| PyPI | tenacity | 9.1.2 | direct |
| PyPI | typer | — | direct |
| PyPI | typer | 0.16.1 | direct |
| PyPI | typer | 0.23.2 | direct |
| PyPI | aiohappyeyeballs | 2.6.1 | indirect |
| PyPI | aiosignal | 1.4.0 | indirect |
| PyPI | annotated-doc | 0.0.4 | indirect |
| PyPI | annotated-types | 0.7.0 | indirect |
| PyPI | anthropic | 0.93.0 | indirect |
| PyPI | anyio | 4.10.0 | indirect |
| PyPI | anyio | 4.12.1 | indirect |
| PyPI | appnope | 0.1.4 | indirect |
| PyPI | asttokens | 3.0.0 | indirect |
| PyPI | async-timeout | 5.0.1 | indirect |
| PyPI | attrs | 25.3.0 | indirect |
| PyPI | attrs | 26.1.0 | indirect |
| PyPI | babel | 2.17.0 | indirect |
| PyPI | backrefs | 5.9 | indirect |
| PyPI | beautifulsoup4 | 4.13.5 | indirect |
| PyPI | black | 25.1.0 | indirect |
| PyPI | bleach | 6.2.0 | indirect |
| PyPI | boto3 | 1.40.19 | indirect |
| PyPI | botocore | 1.40.19 | indirect |
| PyPI | cachecontrol | 0.14.3 | indirect |
| PyPI | cachetools | 5.5.2 | indirect |
| PyPI | cairocffi | 1.7.1 | indirect |
| PyPI | cairosvg | — | indirect |
| PyPI | cairosvg | 2.8.2 | indirect |
| PyPI | cerebras-cloud-sdk | 1.46.0 | indirect |
| PyPI | certifi | 2025.8.3 | indirect |
| PyPI | certifi | 2026.2.25 | indirect |
| PyPI | cffi | 1.17.1 | indirect |
| PyPI | cfgv | 3.4.0 | indirect |
| PyPI | charset-normalizer | 3.4.3 | indirect |
| PyPI | charset-normalizer | 3.4.7 | indirect |
| PyPI | click | 8.1.8 | indirect |
| PyPI | click | 8.2.1 | indirect |
| PyPI | click | 8.3.1 | indirect |
| PyPI | cohere | — | indirect |
| PyPI | cohere | 5.17.0 | indirect |
| PyPI | colorama | 0.4.6 | indirect |
| PyPI | comm | 0.2.3 | indirect |
| PyPI | courlan | 1.3.2 | indirect |
| PyPI | coverage | 7.10.5 | indirect |
| PyPI | csscompressor | 0.9.5 | indirect |
| PyPI | cssselect2 | 0.8.0 | indirect |
| PyPI | datasets | — | indirect |
| PyPI | datasets | 3.6.0 | indirect |
| PyPI | dateparser | 1.2.2 | indirect |
| PyPI | debugpy | 1.8.16 | indirect |
| PyPI | decorator | 5.2.1 | indirect |
| PyPI | defusedxml | 0.7.1 | indirect |
| PyPI | dill | 0.3.8 | indirect |
| PyPI | diskcache | 5.6.3 | indirect |
| PyPI | distlib | 0.4.0 | indirect |
| PyPI | distro | 1.9.0 | indirect |
| PyPI | exceptiongroup | 1.3.0 | indirect |
| PyPI | execnet | 2.1.1 | indirect |
| PyPI | executing | 2.2.0 | indirect |
| PyPI | fastapi | — | indirect |
| PyPI | fastapi | 0.110.3 | indirect |
| PyPI | fastapi | 0.115.14 | indirect |
| PyPI | fastavro | 1.12.0 | indirect |
| PyPI | fastjsonschema | 2.21.2 | indirect |
| PyPI | filelock | 3.19.1 | indirect |
| PyPI | fireworks-ai | 0.15.15 | indirect |
| PyPI | frozenlist | 1.7.0 | indirect |
| PyPI | frozenlist | 1.8.0 | indirect |
| PyPI | fsspec | 2025.3.0 | indirect |
| PyPI | ghp-import | 2.1.0 | indirect |
| PyPI | gitdb | 4.0.12 | indirect |
| PyPI | gitpython | 3.1.45 | indirect |
| PyPI | google-api-core | 2.25.1 | indirect |
| PyPI | google-auth | 2.40.3 | indirect |
| PyPI | google-cloud-aiplatform | 1.111.0 | indirect |
| PyPI | google-cloud-bigquery | 3.36.0 | indirect |
| PyPI | google-cloud-core | 2.4.3 | indirect |
| PyPI | google-cloud-resource-manager | 1.14.2 | indirect |
| PyPI | google-cloud-storage | 2.19.0 | indirect |
| PyPI | google-crc32c | 1.7.1 | indirect |
| PyPI | google-genai | 1.31.0 | indirect |
| PyPI | google-resumable-media | 2.7.2 | indirect |
| PyPI | googleapis-common-protos | 1.70.0 | indirect |
| PyPI | graphviz | 0.21 | indirect |
| PyPI | greenlet | 3.2.4 | indirect |
| PyPI | griffe | 1.13.0 | indirect |
| PyPI | groq | 0.26.0 | indirect |
| PyPI | grpc-google-iam-v1 | 0.14.2 | indirect |
| PyPI | grpcio | 1.74.0 | indirect |
| PyPI | grpcio-status | 1.74.0 | indirect |
| PyPI | h11 | 0.16.0 | indirect |
| PyPI | hf-xet | 1.1.8 | indirect |
| PyPI | htmldate | 1.9.3 | indirect |
| PyPI | htmlmin2 | 0.1.13 | indirect |
| PyPI | httpcore | 1.0.9 | indirect |
| PyPI | httpx | 0.28.1 | indirect |
| PyPI | httpx-sse | 0.4.0 | indirect |
| PyPI | httpx-ws | 0.7.2 | indirect |
| PyPI | huggingface-hub | 0.34.4 | indirect |
| PyPI | identify | 2.6.13 | indirect |
| PyPI | idna | 3.10 | indirect |
| PyPI | idna | 3.11 | indirect |
| PyPI | importlib-metadata | 8.7.0 | indirect |
| PyPI | iniconfig | 2.1.0 | indirect |
| PyPI | instructor | — | indirect |
| PyPI | instructor | 1.0.3 | indirect |
| PyPI | instructor | 1.15.5 | indirect |
| PyPI | invoke | 2.2.0 | indirect |
| PyPI | ipykernel | 6.30.1 | indirect |
| PyPI | ipython | 8.18.1 | indirect |
| PyPI | ipython | 8.37.0 | indirect |
| PyPI | ipython | 9.4.0 | indirect |
| PyPI | ipython-pygments-lexers | 1.1.1 | indirect |
| PyPI | jedi | 0.19.2 | indirect |
| PyPI | jmespath | 1.0.1 | indirect |
| PyPI | jsmin | 3.0.1 | indirect |
| PyPI | jsonref | 1.1.0 | indirect |
| PyPI | jsonschema | 4.25.1 | indirect |
| PyPI | jsonschema-specifications | 2025.4.1 | indirect |
| PyPI | jupyter-client | 8.6.3 | indirect |
| PyPI | jupyter-core | 5.8.1 | indirect |
| PyPI | jupyterlab-pygments | 0.3.0 | indirect |
| PyPI | jupytext | 1.17.2 | indirect |
| PyPI | justext | 3.0.2 | indirect |
| PyPI | litellm | 1.76.0 | indirect |
| PyPI | logfire | — | indirect |
| PyPI | logfire | 0.28.0 | indirect |
| PyPI | lxml | 5.4.0 | indirect |
| PyPI | lxml-html-clean | 0.4.2 | indirect |
| PyPI | markdown | 3.8.2 | indirect |
| PyPI | markdown-it-py | 3.0.0 | indirect |
| PyPI | markdownify | 1.2.2 | indirect |
| PyPI | markupsafe | 3.0.2 | indirect |
| PyPI | markupsafe | 3.0.3 | indirect |
| PyPI | matplotlib-inline | 0.1.7 | indirect |
| PyPI | mdformat | 0.7.22 | indirect |
| PyPI | mdformat-tables | 1.0.0 | indirect |
| PyPI | mdit-py-plugins | 0.4.2 | indirect |
| PyPI | mdit-py-plugins | 0.5.0 | indirect |
| PyPI | mdurl | 0.1.2 | indirect |
| PyPI | mergedeep | 1.3.4 | indirect |
| PyPI | mistralai | 1.9.9 | indirect |
| PyPI | mistune | 3.1.3 | indirect |
| PyPI | mkdocs | — | indirect |
| PyPI | mkdocs | 1.6.1 | indirect |
| PyPI | mkdocs-autorefs | 1.4.3 | indirect |
| PyPI | mkdocs-get-deps | 0.2.0 | indirect |
| PyPI | mkdocs-jupyter | — | indirect |
| PyPI | mkdocs-jupyter | 0.25.1 | indirect |
| PyPI | mkdocs-llmstxt | — | indirect |
| PyPI | mkdocs-llmstxt | 0.5.0 | indirect |
| PyPI | mkdocs-material | 9.6.18 | indirect |
| PyPI | mkdocs-material-extensions | 1.3.1 | indirect |
| PyPI | mkdocs-minify-plugin | — | indirect |
| PyPI | mkdocs-minify-plugin | 0.8.0 | indirect |
| PyPI | mkdocs-redirects | — | indirect |
| PyPI | mkdocs-redirects | 1.2.2 | indirect |
| PyPI | mkdocs-rss-plugin | 1.17.3 | indirect |
| PyPI | mkdocstrings | — | indirect |
| PyPI | mkdocstrings | 0.29.1 | indirect |
| PyPI | mkdocstrings-python | — | indirect |
| PyPI | mkdocstrings-python | 1.16.12 | indirect |
| PyPI | msgpack | 1.1.1 | indirect |
| PyPI | multidict | 6.6.4 | indirect |
| PyPI | multidict | 6.7.1 | indirect |
| PyPI | multiprocess | 0.70.16 | indirect |
| PyPI | mypy-extensions | 1.1.0 | indirect |
| PyPI | nbclient | 0.10.2 | indirect |
| PyPI | nbconvert | 7.16.6 | indirect |
| PyPI | nbformat | 5.10.4 | indirect |
| PyPI | nest-asyncio | 1.6.0 | indirect |
| PyPI | nltk | — | indirect |
| PyPI | nodeenv | 1.9.1 | indirect |
| PyPI | numpy | 2.0.2 | indirect |
| PyPI | numpy | 2.2.6 | indirect |
| PyPI | numpy | 2.3.2 | indirect |
| PyPI | opentelemetry-api | 1.36.0 | indirect |
| PyPI | opentelemetry-sdk | 1.36.0 | indirect |
| PyPI | opentelemetry-semantic-conventions | 0.57b0 | indirect |
| PyPI | packaging | 25.0 | indirect |
| PyPI | paginate | 0.5.7 | indirect |
| PyPI | pandas | 2.3.2 | indirect |
| PyPI | pandocfilters | 1.5.1 | indirect |
| PyPI | parso | 0.8.5 | indirect |
| PyPI | pathspec | 0.12.1 | indirect |
| PyPI | pexpect | 4.9.0 | indirect |
| PyPI | phonenumbers | 9.0.12 | indirect |
| PyPI | pillow | — | indirect |
| PyPI | pillow | 10.4.0 | indirect |
| PyPI | platformdirs | 4.4.0 | indirect |
| PyPI | pluggy | 1.6.0 | indirect |
| PyPI | pre-commit | 4.3.0 | indirect |
| PyPI | prompt-toolkit | 3.0.52 | indirect |
| PyPI | propcache | 0.3.2 | indirect |
| PyPI | propcache | 0.4.1 | indirect |
| PyPI | proto-plus | 1.26.1 | indirect |
| PyPI | protobuf | 6.32.0 | indirect |
| PyPI | psutil | 7.0.0 | indirect |
| PyPI | ptyprocess | 0.7.0 | indirect |
| PyPI | pure-eval | 0.2.3 | indirect |
| PyPI | pyarrow | 21.0.0 | indirect |
| PyPI | pyasn1 | 0.6.1 | indirect |
| PyPI | pyasn1-modules | 0.4.2 | indirect |
| PyPI | pycparser | 2.22 | indirect |
| PyPI | pydantic-extra-types | 2.10.5 | indirect |
| PyPI | pydub | 0.25.1 | indirect |
| PyPI | pygments | 2.19.2 | indirect |
| PyPI | pygments | 2.20.0 | indirect |
| PyPI | pymdown-extensions | 10.16.1 | indirect |
| PyPI | pytest | 8.4.1 | indirect |
| PyPI | pytest-asyncio | 0.26.0 | indirect |
| PyPI | pytest-examples | 0.0.18 | indirect |
| PyPI | pytest-xdist | 3.8.0 | indirect |
| PyPI | python-dateutil | 2.9.0.post0 | indirect |
| PyPI | python-dotenv | 1.1.1 | indirect |
| PyPI | pytz | 2025.2 | indirect |
| PyPI | pywin32 | 311 | indirect |
| PyPI | pyyaml | 6.0.2 | indirect |
| PyPI | pyyaml-env-tag | 1.1 | indirect |
| PyPI | pyzmq | 27.0.2 | indirect |
| PyPI | redis | 6.4.0 | indirect |
| PyPI | referencing | 0.36.2 | indirect |
| PyPI | regex | — | indirect |
| PyPI | regex | 2025.7.34 | indirect |
| PyPI | rpds-py | 0.27.1 | indirect |
| PyPI | rsa | 4.9.1 | indirect |
| PyPI | ruff | 0.11.13 | indirect |
| PyPI | ruff | 0.15.10 | indirect |
| PyPI | s3transfer | 0.13.1 | indirect |
| PyPI | shapely | 2.0.7 | indirect |
| PyPI | shapely | 2.1.1 | indirect |
| PyPI | shellingham | 1.5.4 | indirect |
| PyPI | six | 1.17.0 | indirect |
| PyPI | smmap | 5.0.2 | indirect |
| PyPI | sniffio | 1.3.1 | indirect |
| PyPI | soupsieve | 2.8 | indirect |
| PyPI | sqlalchemy | 2.0.43 | indirect |
| PyPI | sqlmodel | 0.0.24 | indirect |
| PyPI | stack-data | 0.6.3 | indirect |
| PyPI | starlette | 0.46.2 | indirect |
| PyPI | tabulate | 0.9.0 | indirect |
| PyPI | tiktoken | 0.11.0 | indirect |
| PyPI | tinycss2 | 1.4.0 | indirect |
| PyPI | tld | 0.13.1 | indirect |
| PyPI | tokenizers | 0.21.4 | indirect |
| PyPI | tomli | 2.2.1 | indirect |
| PyPI | tornado | 6.5.2 | indirect |
| PyPI | tqdm | 4.67.1 | indirect |
| PyPI | tqdm | 4.67.3 | indirect |
| PyPI | trafilatura | — | indirect |
| PyPI | trafilatura | 2.0.0 | indirect |
| PyPI | traitlets | 5.14.3 | indirect |
| PyPI | ty | 0.0.44 | indirect |
| PyPI | types-requests | 2.31.0.6 | indirect |
| PyPI | types-requests | 2.32.4.20250809 | indirect |
| PyPI | types-urllib3 | 1.26.25.14 | indirect |
| PyPI | typing-extensions | 4.15.0 | indirect |
| PyPI | typing-inspection | 0.4.1 | indirect |
| PyPI | typing-inspection | 0.4.2 | indirect |
| PyPI | tzdata | 2024.2 | indirect |
| PyPI | tzlocal | 5.3.1 | indirect |
| PyPI | urllib3 | 1.26.20 | indirect |
| PyPI | urllib3 | 2.5.0 | indirect |
| PyPI | urllib3 | 2.6.3 | indirect |
| PyPI | uvicorn | — | indirect |
| PyPI | virtualenv | 20.34.0 | indirect |
| PyPI | watchdog | 6.0.0 | indirect |
| PyPI | wcwidth | 0.2.13 | indirect |
| PyPI | webencodings | 0.5.1 | indirect |
| PyPI | websockets | 15.0.1 | indirect |
| PyPI | writer-sdk | 2.3.1 | indirect |
| PyPI | wsproto | 1.2.0 | indirect |
| PyPI | xai-sdk | 1.1.0 | indirect |
| PyPI | xmltodict | 0.14.2 | indirect |
| PyPI | xxhash | 3.5.0 | indirect |
| PyPI | yarl | 1.20.1 | indirect |
| PyPI | yarl | 1.22.0 | indirect |
| PyPI | zipp | 3.23.0 | indirect |
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"openai",
"python",
"pydantic-v2",
"openai-functions",
"validation",
"openai-function-calli"
],
"is_fork": false,
"size_kb": 78722,
"has_wiki": true,
"homepage": "https://python.useinstructor.com/",
"languages": {
"Shell": 1101,
"Python": 2307452
},
"pushed_at": "2026-07-13T06:07:46Z",
"created_at": "2023-06-14T10:42:23Z",
"owner_type": "Organization",
"updated_at": "2026-07-18T08:30:31Z",
"description": "structured outputs for llms ",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": null,
"name": null,
"type": "Organization",
"login": "567-labs",
"company": null,
"followers": 130,
"avatar_url": "https://avatars.githubusercontent.com/u/152629781?v=4",
"created_at": "2023-12-01T14:50:36Z",
"is_verified": null,
"public_repos": 4,
"account_age_days": 959
},
"activity": {
"releases_count": 100,
"commits_last_year": 237,
"latest_release_at": "2026-06-28T07:36:13Z",
"latest_release_tag": "v1.15.4",
"releases_from_tags": false,
"days_since_last_push": 5,
"active_weeks_last_year": 36,
"days_since_latest_release": 20,
"mean_days_between_releases": 19
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 62,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "instructor",
"exists": true,
"license": "MIT",
"keywords": [],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/instructor/",
"is_deprecated": false,
"latest_version": "1.15.4",
"repository_url": "https://github.com/instructor-ai/instructor",
"versions_count": 96,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": null,
"first_published_at": "2023-07-28T04:55:40.579777Z",
"latest_published_at": "2026-06-28T07:36:43.458297Z",
"latest_version_yanked": null,
"days_since_latest_publish": 20
}
]
},
"popularity": {
"forks": 1157,
"stars": 13554,
"watchers": 53,
"open_issues_and_prs": 72
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples",
"notebooks"
],
"has_llms_txt": true,
"has_dockerfile": true,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"instructor/py.typed"
],
"largest_source_bytes": 48861,
"source_files_sampled": 542,
"oversized_source_files": 0,
"agent_instruction_files": [
".cursor/rules/documentation-sync.mdc",
".cursor/rules/followups.mdc",
".cursor/rules/new-features-planning.mdc",
".cursor/rules/readme.md",
".cursor/rules/simple-language.mdc",
"AGENT.md",
"CLAUDE.md",
"docs/AGENT.md"
],
"agent_instruction_max_bytes": 13329
},
"dependencies": {
"manifests": [
"pyproject.toml",
"requirements-doc.txt",
"requirements-examples.txt",
"requirements.txt"
],
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "openai",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.0.0,<3.0.0"
},
{
"name": "pydantic",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<3.0.0,>=2.8.0"
},
{
"name": "eval-type-backport",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.2.2"
},
{
"name": "docstring-parser",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<1.0,>=0.16"
},
{
"name": "typer",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<1.0.0,>=0.9.0"
},
{
"name": "rich",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<15.0.0,>=13.7.0"
},
{
"name": "aiohttp",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<4.0.0,>=3.9.1"
},
{
"name": "tenacity",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<10.0.0,>=8.2.3"
},
{
"name": "pydantic-core",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<3.0.0,>=2.18.0"
},
{
"name": "jiter",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.6.1,<0.15"
},
{
"name": "jinja2",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<4.0.0,>=3.1.4"
},
{
"name": "requests",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "<3.0.0,>=2.32.3"
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "aiohttp",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "aiohttp",
"direct": true,
"version": "3.12.15",
"ecosystem": "pypi"
},
{
"name": "aiohttp",
"direct": true,
"version": "3.13.5",
"ecosystem": "pypi"
},
{
"name": "docstring-parser",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "docstring-parser",
"direct": true,
"version": "0.17.0",
"ecosystem": "pypi"
},
{
"name": "eval-type-backport",
"direct": true,
"version": "0.2.2",
"ecosystem": "pypi"
},
{
"name": "jinja2",
"direct": true,
"version": "3.1.6",
"ecosystem": "pypi"
},
{
"name": "jiter",
"direct": true,
"version": "0.10.0",
"ecosystem": "pypi"
},
{
"name": "jiter",
"direct": true,
"version": "0.14.0",
"ecosystem": "pypi"
},
{
"name": "openai",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "openai",
"direct": true,
"version": "1.24.1",
"ecosystem": "pypi"
},
{
"name": "openai",
"direct": true,
"version": "2.31.0",
"ecosystem": "pypi"
},
{
"name": "openai",
"direct": true,
"version": "2.6.0",
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": true,
"version": "2.11.7",
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": true,
"version": "2.12.5",
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": true,
"version": "2.7.1",
"ecosystem": "pypi"
},
{
"name": "pydantic-core",
"direct": true,
"version": "2.33.2",
"ecosystem": "pypi"
},
{
"name": "pydantic-core",
"direct": true,
"version": "2.41.5",
"ecosystem": "pypi"
},
{
"name": "requests",
"direct": true,
"version": "2.32.5",
"ecosystem": "pypi"
},
{
"name": "rich",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "rich",
"direct": true,
"version": "14.1.0",
"ecosystem": "pypi"
},
{
"name": "rich",
"direct": true,
"version": "14.3.3",
"ecosystem": "pypi"
},
{
"name": "tenacity",
"direct": true,
"version": "9.1.2",
"ecosystem": "pypi"
},
{
"name": "typer",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "typer",
"direct": true,
"version": "0.16.1",
"ecosystem": "pypi"
},
{
"name": "typer",
"direct": true,
"version": "0.23.2",
"ecosystem": "pypi"
},
{
"name": "aiohappyeyeballs",
"direct": false,
"version": "2.6.1",
"ecosystem": "pypi"
},
{
"name": "aiosignal",
"direct": false,
"version": "1.4.0",
"ecosystem": "pypi"
},
{
"name": "annotated-doc",
"direct": false,
"version": "0.0.4",
"ecosystem": "pypi"
},
{
"name": "annotated-types",
"direct": false,
"version": "0.7.0",
"ecosystem": "pypi"
},
{
"name": "anthropic",
"direct": false,
"version": "0.93.0",
"ecosystem": "pypi"
},
{
"name": "anyio",
"direct": false,
"version": "4.10.0",
"ecosystem": "pypi"
},
{
"name": "anyio",
"direct": false,
"version": "4.12.1",
"ecosystem": "pypi"
},
{
"name": "appnope",
"direct": false,
"version": "0.1.4",
"ecosystem": "pypi"
},
{
"name": "asttokens",
"direct": false,
"version": "3.0.0",
"ecosystem": "pypi"
},
{
"name": "async-timeout",
"direct": false,
"version": "5.0.1",
"ecosystem": "pypi"
},
{
"name": "attrs",
"direct": false,
"version": "25.3.0",
"ecosystem": "pypi"
},
{
"name": "attrs",
"direct": false,
"version": "26.1.0",
"ecosystem": "pypi"
},
{
"name": "babel",
"direct": false,
"version": "2.17.0",
"ecosystem": "pypi"
},
{
"name": "backrefs",
"direct": false,
"version": "5.9",
"ecosystem": "pypi"
},
{
"name": "beautifulsoup4",
"direct": false,
"version": "4.13.5",
"ecosystem": "pypi"
},
{
"name": "black",
"direct": false,
"version": "25.1.0",
"ecosystem": "pypi"
},
{
"name": "bleach",
"direct": false,
"version": "6.2.0",
"ecosystem": "pypi"
},
{
"name": "boto3",
"direct": false,
"version": "1.40.19",
"ecosystem": "pypi"
},
{
"name": "botocore",
"direct": false,
"version": "1.40.19",
"ecosystem": "pypi"
},
{
"name": "cachecontrol",
"direct": false,
"version": "0.14.3",
"ecosystem": "pypi"
},
{
"name": "cachetools",
"direct": false,
"version": "5.5.2",
"ecosystem": "pypi"
},
{
"name": "cairocffi",
"direct": false,
"version": "1.7.1",
"ecosystem": "pypi"
},
{
"name": "cairosvg",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "cairosvg",
"direct": false,
"version": "2.8.2",
"ecosystem": "pypi"
},
{
"name": "cerebras-cloud-sdk",
"direct": false,
"version": "1.46.0",
"ecosystem": "pypi"
},
{
"name": "certifi",
"direct": false,
"version": "2025.8.3",
"ecosystem": "pypi"
},
{
"name": "certifi",
"direct": false,
"version": "2026.2.25",
"ecosystem": "pypi"
},
{
"name": "cffi",
"direct": false,
"version": "1.17.1",
"ecosystem": "pypi"
},
{
"name": "cfgv",
"direct": false,
"version": "3.4.0",
"ecosystem": "pypi"
},
{
"name": "charset-normalizer",
"direct": false,
"version": "3.4.3",
"ecosystem": "pypi"
},
{
"name": "charset-normalizer",
"direct": false,
"version": "3.4.7",
"ecosystem": "pypi"
},
{
"name": "click",
"direct": false,
"version": "8.1.8",
"ecosystem": "pypi"
},
{
"name": "click",
"direct": false,
"version": "8.2.1",
"ecosystem": "pypi"
},
{
"name": "click",
"direct": false,
"version": "8.3.1",
"ecosystem": "pypi"
},
{
"name": "cohere",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "cohere",
"direct": false,
"version": "5.17.0",
"ecosystem": "pypi"
},
{
"name": "colorama",
"direct": false,
"version": "0.4.6",
"ecosystem": "pypi"
},
{
"name": "comm",
"direct": false,
"version": "0.2.3",
"ecosystem": "pypi"
},
{
"name": "courlan",
"direct": false,
"version": "1.3.2",
"ecosystem": "pypi"
},
{
"name": "coverage",
"direct": false,
"version": "7.10.5",
"ecosystem": "pypi"
},
{
"name": "csscompressor",
"direct": false,
"version": "0.9.5",
"ecosystem": "pypi"
},
{
"name": "cssselect2",
"direct": false,
"version": "0.8.0",
"ecosystem": "pypi"
},
{
"name": "datasets",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "datasets",
"direct": false,
"version": "3.6.0",
"ecosystem": "pypi"
},
{
"name": "dateparser",
"direct": false,
"version": "1.2.2",
"ecosystem": "pypi"
},
{
"name": "debugpy",
"direct": false,
"version": "1.8.16",
"ecosystem": "pypi"
},
{
"name": "decorator",
"direct": false,
"version": "5.2.1",
"ecosystem": "pypi"
},
{
"name": "defusedxml",
"direct": false,
"version": "0.7.1",
"ecosystem": "pypi"
},
{
"name": "dill",
"direct": false,
"version": "0.3.8",
"ecosystem": "pypi"
},
{
"name": "diskcache",
"direct": false,
"version": "5.6.3",
"ecosystem": "pypi"
},
{
"name": "distlib",
"direct": false,
"version": "0.4.0",
"ecosystem": "pypi"
},
{
"name": "distro",
"direct": false,
"version": "1.9.0",
"ecosystem": "pypi"
},
{
"name": "exceptiongroup",
"direct": false,
"version": "1.3.0",
"ecosystem": "pypi"
},
{
"name": "execnet",
"direct": false,
"version": "2.1.1",
"ecosystem": "pypi"
},
{
"name": "executing",
"direct": false,
"version": "2.2.0",
"ecosystem": "pypi"
},
{
"name": "fastapi",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "fastapi",
"direct": false,
"version": "0.110.3",
"ecosystem": "pypi"
},
{
"name": "fastapi",
"direct": false,
"version": "0.115.14",
"ecosystem": "pypi"
},
{
"name": "fastavro",
"direct": false,
"version": "1.12.0",
"ecosystem": "pypi"
},
{
"name": "fastjsonschema",
"direct": false,
"version": "2.21.2",
"ecosystem": "pypi"
},
{
"name": "filelock",
"direct": false,
"version": "3.19.1",
"ecosystem": "pypi"
},
{
"name": "fireworks-ai",
"direct": false,
"version": "0.15.15",
"ecosystem": "pypi"
},
{
"name": "frozenlist",
"direct": false,
"version": "1.7.0",
"ecosystem": "pypi"
},
{
"name": "frozenlist",
"direct": false,
"version": "1.8.0",
"ecosystem": "pypi"
},
{
"name": "fsspec",
"direct": false,
"version": "2025.3.0",
"ecosystem": "pypi"
},
{
"name": "ghp-import",
"direct": false,
"version": "2.1.0",
"ecosystem": "pypi"
},
{
"name": "gitdb",
"direct": false,
"version": "4.0.12",
"ecosystem": "pypi"
},
{
"name": "gitpython",
"direct": false,
"version": "3.1.45",
"ecosystem": "pypi"
},
{
"name": "google-api-core",
"direct": false,
"version": "2.25.1",
"ecosystem": "pypi"
},
{
"name": "google-auth",
"direct": false,
"version": "2.40.3",
"ecosystem": "pypi"
},
{
"name": "google-cloud-aiplatform",
"direct": false,
"version": "1.111.0",
"ecosystem": "pypi"
},
{
"name": "google-cloud-bigquery",
"direct": false,
"version": "3.36.0",
"ecosystem": "pypi"
},
{
"name": "google-cloud-core",
"direct": false,
"version": "2.4.3",
"ecosystem": "pypi"
},
{
"name": "google-cloud-resource-manager",
"direct": false,
"version": "1.14.2",
"ecosystem": "pypi"
},
{
"name": "google-cloud-storage",
"direct": false,
"version": "2.19.0",
"ecosystem": "pypi"
},
{
"name": "google-crc32c",
"direct": false,
"version": "1.7.1",
"ecosystem": "pypi"
},
{
"name": "google-genai",
"direct": false,
"version": "1.31.0",
"ecosystem": "pypi"
},
{
"name": "google-resumable-media",
"direct": false,
"version": "2.7.2",
"ecosystem": "pypi"
},
{
"name": "googleapis-common-protos",
"direct": false,
"version": "1.70.0",
"ecosystem": "pypi"
},
{
"name": "graphviz",
"direct": false,
"version": "0.21",
"ecosystem": "pypi"
},
{
"name": "greenlet",
"direct": false,
"version": "3.2.4",
"ecosystem": "pypi"
},
{
"name": "griffe",
"direct": false,
"version": "1.13.0",
"ecosystem": "pypi"
},
{
"name": "groq",
"direct": false,
"version": "0.26.0",
"ecosystem": "pypi"
},
{
"name": "grpc-google-iam-v1",
"direct": false,
"version": "0.14.2",
"ecosystem": "pypi"
},
{
"name": "grpcio",
"direct": false,
"version": "1.74.0",
"ecosystem": "pypi"
},
{
"name": "grpcio-status",
"direct": false,
"version": "1.74.0",
"ecosystem": "pypi"
},
{
"name": "h11",
"direct": false,
"version": "0.16.0",
"ecosystem": "pypi"
},
{
"name": "hf-xet",
"direct": false,
"version": "1.1.8",
"ecosystem": "pypi"
},
{
"name": "htmldate",
"direct": false,
"version": "1.9.3",
"ecosystem": "pypi"
},
{
"name": "htmlmin2",
"direct": false,
"version": "0.1.13",
"ecosystem": "pypi"
},
{
"name": "httpcore",
"direct": false,
"version": "1.0.9",
"ecosystem": "pypi"
},
{
"name": "httpx",
"direct": false,
"version": "0.28.1",
"ecosystem": "pypi"
},
{
"name": "httpx-sse",
"direct": false,
"version": "0.4.0",
"ecosystem": "pypi"
},
{
"name": "httpx-ws",
"direct": false,
"version": "0.7.2",
"ecosystem": "pypi"
},
{
"name": "huggingface-hub",
"direct": false,
"version": "0.34.4",
"ecosystem": "pypi"
},
{
"name": "identify",
"direct": false,
"version": "2.6.13",
"ecosystem": "pypi"
},
{
"name": "idna",
"direct": false,
"version": "3.10",
"ecosystem": "pypi"
},
{
"name": "idna",
"direct": false,
"version": "3.11",
"ecosystem": "pypi"
},
{
"name": "importlib-metadata",
"direct": false,
"version": "8.7.0",
"ecosystem": "pypi"
},
{
"name": "iniconfig",
"direct": false,
"version": "2.1.0",
"ecosystem": "pypi"
},
{
"name": "instructor",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "instructor",
"direct": false,
"version": "1.0.3",
"ecosystem": "pypi"
},
{
"name": "instructor",
"direct": false,
"version": "1.15.5",
"ecosystem": "pypi"
},
{
"name": "invoke",
"direct": false,
"version": "2.2.0",
"ecosystem": "pypi"
},
{
"name": "ipykernel",
"direct": false,
"version": "6.30.1",
"ecosystem": "pypi"
},
{
"name": "ipython",
"direct": false,
"version": "8.18.1",
"ecosystem": "pypi"
},
{
"name": "ipython",
"direct": false,
"version": "8.37.0",
"ecosystem": "pypi"
},
{
"name": "ipython",
"direct": false,
"version": "9.4.0",
"ecosystem": "pypi"
},
{
"name": "ipython-pygments-lexers",
"direct": false,
"version": "1.1.1",
"ecosystem": "pypi"
},
{
"name": "jedi",
"direct": false,
"version": "0.19.2",
"ecosystem": "pypi"
},
{
"name": "jmespath",
"direct": false,
"version": "1.0.1",
"ecosystem": "pypi"
},
{
"name": "jsmin",
"direct": false,
"version": "3.0.1",
"ecosystem": "pypi"
},
{
"name": "jsonref",
"direct": false,
"version": "1.1.0",
"ecosystem": "pypi"
},
{
"name": "jsonschema",
"direct": false,
"version": "4.25.1",
"ecosystem": "pypi"
},
{
"name": "jsonschema-specifications",
"direct": false,
"version": "2025.4.1",
"ecosystem": "pypi"
},
{
"name": "jupyter-client",
"direct": false,
"version": "8.6.3",
"ecosystem": "pypi"
},
{
"name": "jupyter-core",
"direct": false,
"version": "5.8.1",
"ecosystem": "pypi"
},
{
"name": "jupyterlab-pygments",
"direct": false,
"version": "0.3.0",
"ecosystem": "pypi"
},
{
"name": "jupytext",
"direct": false,
"version": "1.17.2",
"ecosystem": "pypi"
},
{
"name": "justext",
"direct": false,
"version": "3.0.2",
"ecosystem": "pypi"
},
{
"name": "litellm",
"direct": false,
"version": "1.76.0",
"ecosystem": "pypi"
},
{
"name": "logfire",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "logfire",
"direct": false,
"version": "0.28.0",
"ecosystem": "pypi"
},
{
"name": "lxml",
"direct": false,
"version": "5.4.0",
"ecosystem": "pypi"
},
{
"name": "lxml-html-clean",
"direct": false,
"version": "0.4.2",
"ecosystem": "pypi"
},
{
"name": "markdown",
"direct": false,
"version": "3.8.2",
"ecosystem": "pypi"
},
{
"name": "markdown-it-py",
"direct": false,
"version": "3.0.0",
"ecosystem": "pypi"
},
{
"name": "markdownify",
"direct": false,
"version": "1.2.2",
"ecosystem": "pypi"
},
{
"name": "markupsafe",
"direct": false,
"version": "3.0.2",
"ecosystem": "pypi"
},
{
"name": "markupsafe",
"direct": false,
"version": "3.0.3",
"ecosystem": "pypi"
},
{
"name": "matplotlib-inline",
"direct": false,
"version": "0.1.7",
"ecosystem": "pypi"
},
{
"name": "mdformat",
"direct": false,
"version": "0.7.22",
"ecosystem": "pypi"
},
{
"name": "mdformat-tables",
"direct": false,
"version": "1.0.0",
"ecosystem": "pypi"
},
{
"name": "mdit-py-plugins",
"direct": false,
"version": "0.4.2",
"ecosystem": "pypi"
},
{
"name": "mdit-py-plugins",
"direct": false,
"version": "0.5.0",
"ecosystem": "pypi"
},
{
"name": "mdurl",
"direct": false,
"version": "0.1.2",
"ecosystem": "pypi"
},
{
"name": "mergedeep",
"direct": false,
"version": "1.3.4",
"ecosystem": "pypi"
},
{
"name": "mistralai",
"direct": false,
"version": "1.9.9",
"ecosystem": "pypi"
},
{
"name": "mistune",
"direct": false,
"version": "3.1.3",
"ecosystem": "pypi"
},
{
"name": "mkdocs",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs",
"direct": false,
"version": "1.6.1",
"ecosystem": "pypi"
},
{
"name": "mkdocs-autorefs",
"direct": false,
"version": "1.4.3",
"ecosystem": "pypi"
},
{
"name": "mkdocs-get-deps",
"direct": false,
"version": "0.2.0",
"ecosystem": "pypi"
},
{
"name": "mkdocs-jupyter",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-jupyter",
"direct": false,
"version": "0.25.1",
"ecosystem": "pypi"
},
{
"name": "mkdocs-llmstxt",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-llmstxt",
"direct": false,
"version": "0.5.0",
"ecosystem": "pypi"
},
{
"name": "mkdocs-material",
"direct": false,
"version": "9.6.18",
"ecosystem": "pypi"
},
{
"name": "mkdocs-material-extensions",
"direct": false,
"version": "1.3.1",
"ecosystem": "pypi"
},
{
"name": "mkdocs-minify-plugin",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-minify-plugin",
"direct": false,
"version": "0.8.0",
"ecosystem": "pypi"
},
{
"name": "mkdocs-redirects",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-redirects",
"direct": false,
"version": "1.2.2",
"ecosystem": "pypi"
},
{
"name": "mkdocs-rss-plugin",
"direct": false,
"version": "1.17.3",
"ecosystem": "pypi"
},
{
"name": "mkdocstrings",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocstrings",
"direct": false,
"version": "0.29.1",
"ecosystem": "pypi"
},
{
"name": "mkdocstrings-python",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocstrings-python",
"direct": false,
"version": "1.16.12",
"ecosystem": "pypi"
},
{
"name": "msgpack",
"direct": false,
"version": "1.1.1",
"ecosystem": "pypi"
},
{
"name": "multidict",
"direct": false,
"version": "6.6.4",
"ecosystem": "pypi"
},
{
"name": "multidict",
"direct": false,
"version": "6.7.1",
"ecosystem": "pypi"
},
{
"name": "multiprocess",
"direct": false,
"version": "0.70.16",
"ecosystem": "pypi"
},
{
"name": "mypy-extensions",
"direct": false,
"version": "1.1.0",
"ecosystem": "pypi"
},
{
"name": "nbclient",
"direct": false,
"version": "0.10.2",
"ecosystem": "pypi"
},
{
"name": "nbconvert",
"direct": false,
"version": "7.16.6",
"ecosystem": "pypi"
},
{
"name": "nbformat",
"direct": false,
"version": "5.10.4",
"ecosystem": "pypi"
},
{
"name": "nest-asyncio",
"direct": false,
"version": "1.6.0",
"ecosystem": "pypi"
},
{
"name": "nltk",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "nodeenv",
"direct": false,
"version": "1.9.1",
"ecosystem": "pypi"
},
{
"name": "numpy",
"direct": false,
"version": "2.0.2",
"ecosystem": "pypi"
},
{
"name": "numpy",
"direct": false,
"version": "2.2.6",
"ecosystem": "pypi"
},
{
"name": "numpy",
"direct": false,
"version": "2.3.2",
"ecosystem": "pypi"
},
{
"name": "opentelemetry-api",
"direct": false,
"version": "1.36.0",
"ecosystem": "pypi"
},
{
"name": "opentelemetry-sdk",
"direct": false,
"version": "1.36.0",
"ecosystem": "pypi"
},
{
"name": "opentelemetry-semantic-conventions",
"direct": false,
"version": "0.57b0",
"ecosystem": "pypi"
},
{
"name": "packaging",
"direct": false,
"version": "25.0",
"ecosystem": "pypi"
},
{
"name": "paginate",
"direct": false,
"version": "0.5.7",
"ecosystem": "pypi"
},
{
"name": "pandas",
"direct": false,
"version": "2.3.2",
"ecosystem": "pypi"
},
{
"name": "pandocfilters",
"direct": false,
"version": "1.5.1",
"ecosystem": "pypi"
},
{
"name": "parso",
"direct": false,
"version": "0.8.5",
"ecosystem": "pypi"
},
{
"name": "pathspec",
"direct": false,
"version": "0.12.1",
"ecosystem": "pypi"
},
{
"name": "pexpect",
"direct": false,
"version": "4.9.0",
"ecosystem": "pypi"
},
{
"name": "phonenumbers",
"direct": false,
"version": "9.0.12",
"ecosystem": "pypi"
},
{
"name": "pillow",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pillow",
"direct": false,
"version": "10.4.0",
"ecosystem": "pypi"
},
{
"name": "platformdirs",
"direct": false,
"version": "4.4.0",
"ecosystem": "pypi"
},
{
"name": "pluggy",
"direct": false,
"version": "1.6.0",
"ecosystem": "pypi"
},
{
"name": "pre-commit",
"direct": false,
"version": "4.3.0",
"ecosystem": "pypi"
},
{
"name": "prompt-toolkit",
"direct": false,
"version": "3.0.52",
"ecosystem": "pypi"
},
{
"name": "propcache",
"direct": false,
"version": "0.3.2",
"ecosystem": "pypi"
},
{
"name": "propcache",
"direct": false,
"version": "0.4.1",
"ecosystem": "pypi"
},
{
"name": "proto-plus",
"direct": false,
"version": "1.26.1",
"ecosystem": "pypi"
},
{
"name": "protobuf",
"direct": false,
"version": "6.32.0",
"ecosystem": "pypi"
},
{
"name": "psutil",
"direct": false,
"version": "7.0.0",
"ecosystem": "pypi"
},
{
"name": "ptyprocess",
"direct": false,
"version": "0.7.0",
"ecosystem": "pypi"
},
{
"name": "pure-eval",
"direct": false,
"version": "0.2.3",
"ecosystem": "pypi"
},
{
"name": "pyarrow",
"direct": false,
"version": "21.0.0",
"ecosystem": "pypi"
},
{
"name": "pyasn1",
"direct": false,
"version": "0.6.1",
"ecosystem": "pypi"
},
{
"name": "pyasn1-modules",
"direct": false,
"version": "0.4.2",
"ecosystem": "pypi"
},
{
"name": "pycparser",
"direct": false,
"version": "2.22",
"ecosystem": "pypi"
},
{
"name": "pydantic-extra-types",
"direct": false,
"version": "2.10.5",
"ecosystem": "pypi"
},
{
"name": "pydub",
"direct": false,
"version": "0.25.1",
"ecosystem": "pypi"
},
{
"name": "pygments",
"direct": false,
"version": "2.19.2",
"ecosystem": "pypi"
},
{
"name": "pygments",
"direct": false,
"version": "2.20.0",
"ecosystem": "pypi"
},
{
"name": "pymdown-extensions",
"direct": false,
"version": "10.16.1",
"ecosystem": "pypi"
},
{
"name": "pytest",
"direct": false,
"version": "8.4.1",
"ecosystem": "pypi"
},
{
"name": "pytest-asyncio",
"direct": false,
"version": "0.26.0",
"ecosystem": "pypi"
},
{
"name": "pytest-examples",
"direct": false,
"version": "0.0.18",
"ecosystem": "pypi"
},
{
"name": "pytest-xdist",
"direct": false,
"version": "3.8.0",
"ecosystem": "pypi"
},
{
"name": "python-dateutil",
"direct": false,
"version": "2.9.0.post0",
"ecosystem": "pypi"
},
{
"name": "python-dotenv",
"direct": false,
"version": "1.1.1",
"ecosystem": "pypi"
},
{
"name": "pytz",
"direct": false,
"version": "2025.2",
"ecosystem": "pypi"
},
{
"name": "pywin32",
"direct": false,
"version": "311",
"ecosystem": "pypi"
},
{
"name": "pyyaml",
"direct": false,
"version": "6.0.2",
"ecosystem": "pypi"
},
{
"name": "pyyaml-env-tag",
"direct": false,
"version": "1.1",
"ecosystem": "pypi"
},
{
"name": "pyzmq",
"direct": false,
"version": "27.0.2",
"ecosystem": "pypi"
},
{
"name": "redis",
"direct": false,
"version": "6.4.0",
"ecosystem": "pypi"
},
{
"name": "referencing",
"direct": false,
"version": "0.36.2",
"ecosystem": "pypi"
},
{
"name": "regex",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "regex",
"direct": false,
"version": "2025.7.34",
"ecosystem": "pypi"
},
{
"name": "rpds-py",
"direct": false,
"version": "0.27.1",
"ecosystem": "pypi"
},
{
"name": "rsa",
"direct": false,
"version": "4.9.1",
"ecosystem": "pypi"
},
{
"name": "ruff",
"direct": false,
"version": "0.11.13",
"ecosystem": "pypi"
},
{
"name": "ruff",
"direct": false,
"version": "0.15.10",
"ecosystem": "pypi"
},
{
"name": "s3transfer",
"direct": false,
"version": "0.13.1",
"ecosystem": "pypi"
},
{
"name": "shapely",
"direct": false,
"version": "2.0.7",
"ecosystem": "pypi"
},
{
"name": "shapely",
"direct": false,
"version": "2.1.1",
"ecosystem": "pypi"
},
{
"name": "shellingham",
"direct": false,
"version": "1.5.4",
"ecosystem": "pypi"
},
{
"name": "six",
"direct": false,
"version": "1.17.0",
"ecosystem": "pypi"
},
{
"name": "smmap",
"direct": false,
"version": "5.0.2",
"ecosystem": "pypi"
},
{
"name": "sniffio",
"direct": false,
"version": "1.3.1",
"ecosystem": "pypi"
},
{
"name": "soupsieve",
"direct": false,
"version": "2.8",
"ecosystem": "pypi"
},
{
"name": "sqlalchemy",
"direct": false,
"version": "2.0.43",
"ecosystem": "pypi"
},
{
"name": "sqlmodel",
"direct": false,
"version": "0.0.24",
"ecosystem": "pypi"
},
{
"name": "stack-data",
"direct": false,
"version": "0.6.3",
"ecosystem": "pypi"
},
{
"name": "starlette",
"direct": false,
"version": "0.46.2",
"ecosystem": "pypi"
},
{
"name": "tabulate",
"direct": false,
"version": "0.9.0",
"ecosystem": "pypi"
},
{
"name": "tiktoken",
"direct": false,
"version": "0.11.0",
"ecosystem": "pypi"
},
{
"name": "tinycss2",
"direct": false,
"version": "1.4.0",
"ecosystem": "pypi"
},
{
"name": "tld",
"direct": false,
"version": "0.13.1",
"ecosystem": "pypi"
},
{
"name": "tokenizers",
"direct": false,
"version": "0.21.4",
"ecosystem": "pypi"
},
{
"name": "tomli",
"direct": false,
"version": "2.2.1",
"ecosystem": "pypi"
},
{
"name": "tornado",
"direct": false,
"version": "6.5.2",
"ecosystem": "pypi"
},
{
"name": "tqdm",
"direct": false,
"version": "4.67.1",
"ecosystem": "pypi"
},
{
"name": "tqdm",
"direct": false,
"version": "4.67.3",
"ecosystem": "pypi"
},
{
"name": "trafilatura",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "trafilatura",
"direct": false,
"version": "2.0.0",
"ecosystem": "pypi"
},
{
"name": "traitlets",
"direct": false,
"version": "5.14.3",
"ecosystem": "pypi"
},
{
"name": "ty",
"direct": false,
"version": "0.0.44",
"ecosystem": "pypi"
},
{
"name": "types-requests",
"direct": false,
"version": "2.31.0.6",
"ecosystem": "pypi"
},
{
"name": "types-requests",
"direct": false,
"version": "2.32.4.20250809",
"ecosystem": "pypi"
},
{
"name": "types-urllib3",
"direct": false,
"version": "1.26.25.14",
"ecosystem": "pypi"
},
{
"name": "typing-extensions",
"direct": false,
"version": "4.15.0",
"ecosystem": "pypi"
},
{
"name": "typing-inspection",
"direct": false,
"version": "0.4.1",
"ecosystem": "pypi"
},
{
"name": "typing-inspection",
"direct": false,
"version": "0.4.2",
"ecosystem": "pypi"
},
{
"name": "tzdata",
"direct": false,
"version": "2024.2",
"ecosystem": "pypi"
},
{
"name": "tzlocal",
"direct": false,
"version": "5.3.1",
"ecosystem": "pypi"
},
{
"name": "urllib3",
"direct": false,
"version": "1.26.20",
"ecosystem": "pypi"
},
{
"name": "urllib3",
"direct": false,
"version": "2.5.0",
"ecosystem": "pypi"
},
{
"name": "urllib3",
"direct": false,
"version": "2.6.3",
"ecosystem": "pypi"
},
{
"name": "uvicorn",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "virtualenv",
"direct": false,
"version": "20.34.0",
"ecosystem": "pypi"
},
{
"name": "watchdog",
"direct": false,
"version": "6.0.0",
"ecosystem": "pypi"
},
{
"name": "wcwidth",
"direct": false,
"version": "0.2.13",
"ecosystem": "pypi"
},
{
"name": "webencodings",
"direct": false,
"version": "0.5.1",
"ecosystem": "pypi"
},
{
"name": "websockets",
"direct": false,
"version": "15.0.1",
"ecosystem": "pypi"
},
{
"name": "writer-sdk",
"direct": false,
"version": "2.3.1",
"ecosystem": "pypi"
},
{
"name": "wsproto",
"direct": false,
"version": "1.2.0",
"ecosystem": "pypi"
},
{
"name": "xai-sdk",
"direct": false,
"version": "1.1.0",
"ecosystem": "pypi"
},
{
"name": "xmltodict",
"direct": false,
"version": "0.14.2",
"ecosystem": "pypi"
},
{
"name": "xxhash",
"direct": false,
"version": "3.5.0",
"ecosystem": "pypi"
},
{
"name": "yarl",
"direct": false,
"version": "1.20.1",
"ecosystem": "pypi"
},
{
"name": "yarl",
"direct": false,
"version": "1.22.0",
"ecosystem": "pypi"
},
{
"name": "zipp",
"direct": false,
"version": "3.23.0",
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 301,
"direct_count": 27,
"indirect_count": 274
}
},
"maintainership": {
"issues": {
"open_prs": 51,
"merged_prs": 841,
"open_issues": 21,
"closed_ratio": 0.969,
"closed_issues": 651,
"closed_unmerged_prs": 713
},
"bus_factor": 1,
"top_contributors": [
{
"type": "User",
"login": "jxnl",
"commits": 945,
"avatar_url": "https://avatars.githubusercontent.com/u/4852235?u=f3927adbaafbeaccd6fd4d0bc805414ef08b8b54&v=4"
},
{
"type": "User",
"login": "ivanleomk",
"commits": 168,
"avatar_url": "https://avatars.githubusercontent.com/u/45760326?u=e226dad7ac1fe1c9c0cbde88c9d23dec0a0ec38c&v=4"
},
{
"type": "User",
"login": "DaveOkpare",
"commits": 17,
"avatar_url": "https://avatars.githubusercontent.com/u/19241431?u=164ea66fec042324d7e480ab602b32c15bea8c17&v=4"
},
{
"type": "Bot",
"login": "devin-ai-integration[bot]",
"commits": 15,
"avatar_url": "https://avatars.githubusercontent.com/in/811515?v=4"
},
{
"type": "User",
"login": "shreya-51",
"commits": 12,
"avatar_url": "https://avatars.githubusercontent.com/u/48033781?u=98ec0420f10bb0410cd713f8fc4b9dc007ab5db6&v=4"
},
{
"type": "Bot",
"login": "dependabot[bot]",
"commits": 9,
"avatar_url": "https://avatars.githubusercontent.com/in/29110?v=4"
},
{
"type": "User",
"login": "cursoragent",
"commits": 8,
"avatar_url": "https://avatars.githubusercontent.com/u/199161495?u=78542e6d0b901fe0aa5207ee195f992d2cc6cb3d&v=4"
},
{
"type": "User",
"login": "ssonal",
"commits": 7,
"avatar_url": "https://avatars.githubusercontent.com/u/1973470?u=6b7c975edc250138727d506ce61e6373793bdaac&v=4"
},
{
"type": "User",
"login": "fpingham",
"commits": 7,
"avatar_url": "https://avatars.githubusercontent.com/u/24279597?u=05e329b5fa4f95223f9fbb1daa07118f72e4a071&v=4"
},
{
"type": "User",
"login": "savarin",
"commits": 7,
"avatar_url": "https://avatars.githubusercontent.com/u/5699412?u=1c2ef3f5799facea8bacc90f44907184acf8ecee&v=4"
}
],
"contributors_sampled": 100,
"top_contributor_share": 0.67
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"evals.yml",
"mutation.yml",
"oss-issue-deduplicator.yml",
"oss-issue-tagger.yml",
"python-publish.yml",
"ruff.yml",
"scheduled-release.yml",
"test.yml",
"test_docs.yml",
"ty.yml"
],
"has_docs_dir": true,
"linter_configs": [
".ruff.toml"
],
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"security_signals": {
"lockfiles": [
"uv.lock"
],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": null,
"reason": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 6,
"reason": "17 out of 25 merged PRs checked by a CI test -- score normalized to 6",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 3,
"reason": "Found 10/28 approved changesets -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 10,
"reason": "project has 5 contributing companies or organizations",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 10,
"reason": "update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "14 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 5,
"reason": "dependency not pinned by hash detected -- score normalized to 5",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "124 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "47fdb2ca07119d389a3c0e8bc28b9930b814f294",
"ran_at": "2026-07-18T13:37:46Z",
"aggregate_score": 5.1,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": true
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/instructor-ai/instructor",
"host": "github.com",
"name": "instructor",
"owner": "instructor-ai"
},
"metrics": {
"overall": {
"key": "overall",
"band": "good",
"name": "Overall health",
"note": null,
"notes": [],
"value": 77,
"inputs": {
"security": 51,
"vitality": 93,
"community": 83,
"governance": 64,
"engineering": 92
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "excellent",
"name": "Vitality",
"value": 93,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "excellent",
"name": "Development activity",
"note": null,
"notes": [],
"value": 89,
"inputs": {
"commits_last_year": 237,
"human_commit_share": null,
"days_since_last_push": 5,
"active_weeks_last_year": 36
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 5 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 5
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "36/52 weeks with commits",
"points": 24.9,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 36
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "237 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 237
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "14 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 100,
"inputs": {
"releases_count": 100,
"latest_release_tag": "v1.15.4",
"releases_from_tags": false,
"days_since_latest_release": 20,
"mean_days_between_releases": 19
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "100 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 100
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 20 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 20
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~19 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 19
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "unverified",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": "no_commit_sample",
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": null,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "maintenance record not established from the collected data",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_unverified",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "good",
"name": "Community & Adoption",
"value": 83,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "excellent",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 94,
"inputs": {
"forks": 1157,
"stars": 13554,
"watchers": 53,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "13,554 stars",
"points": 60,
"status": "met",
"details": [
{
"code": "stars",
"params": {
"count": 13554
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "1,157 forks",
"points": 25,
"status": "met",
"details": [
{
"code": "forks",
"params": {
"count": 1157
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "53 watchers",
"points": 9.5,
"status": "partial",
"details": [
{
"code": "watchers",
"params": {
"count": 53
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "good",
"name": "Community health",
"note": null,
"notes": [],
"value": 70,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 64,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "at_risk",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 100,
"top_contributor_share": 0.67
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 67% of commits",
"points": 7.4,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 67
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "100 contributors",
"points": 13.5,
"status": "met",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 100
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 5 contributing companies or organizations",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 70,
"inputs": {
"merged_prs": 841,
"open_issues": 21,
"closed_issues": 651,
"issue_closed_ratio": 0.969,
"closed_unmerged_prs": 713
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "97% of issues closed",
"points": 45.3,
"status": "partial",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 97
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "841/1554 decided PRs merged",
"points": 20.7,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 841,
"decided": 1554
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 10/28 approved changesets -- score normalized to 3",
"points": 4.5,
"status": "partial",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 56,
"inputs": {
"followers": 130,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "567-labs",
"public_repos": 4,
"account_age_days": 959
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "organization-owned",
"points": 30,
"status": "met",
"details": [
{
"code": "owner_organization",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "130 followers of 567-labs",
"points": 15.2,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 130,
"login": "567-labs"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "4 public repos, account ~2 yr old",
"points": 10.3,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 4
}
},
{
"code": "account_age_years",
"params": {
"years": 2
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"instructor"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 20
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 20 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 20
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "96 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 96
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "excellent",
"name": "Engineering Quality",
"value": 92,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "excellent",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 86,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "10 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 10
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": ".ruff.toml",
"points": 16,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".ruff.toml"
}
}
],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 9.6,
"status": "met",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "17 out of 25 merged PRs checked by a CI test -- score normalized to 6",
"points": 12,
"status": "partial",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"topics": [
"openai",
"python",
"pydantic-v2",
"openai-functions",
"validation",
"openai-function-calli"
],
"has_wiki": true,
"homepage": "https://python.useinstructor.com/",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://python.useinstructor.com/",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "6 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 6
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "moderate",
"name": "Security",
"value": 51,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "moderate",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Branch-Protection, Packaging, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"branch_protection",
"packaging",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 51,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 15,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 3,
"scorecard_aggregate": 5.1
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "17 out of 25 merged PRs checked by a CI test -- score normalized to 6",
"points": 1.5,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 10/28 approved changesets -- score normalized to 3",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 5 contributing companies or organizations",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "update tool detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "14 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 5",
"points": 2.5,
"status": "partial",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "124 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 5
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "good",
"name": "AI Readiness",
"value": 77,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "excellent",
"name": "Agent context & guidance",
"note": "Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"legible_commit_history"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 100,
"inputs": {
"has_llms_txt": true,
"legible_history_share": null,
"agent_instruction_files": [
".cursor/rules/documentation-sync.mdc",
".cursor/rules/followups.mdc",
".cursor/rules/new-features-planning.mdc",
".cursor/rules/readme.md",
".cursor/rules/simple-language.mdc",
"AGENT.md",
"CLAUDE.md",
"docs/AGENT.md"
],
"agent_instruction_max_bytes": 13329
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": ".cursor/rules/documentation-sync.mdc, .cursor/rules/followups.mdc, .cursor/rules/new-features-planning.mdc, .cursor/rules/readme.md, .cursor/rules/simple-language.mdc, AGENT.md, CLAUDE.md, docs/AGENT.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".cursor/rules/documentation-sync.mdc, .cursor/rules/followups.mdc, .cursor/rules/new-features-planning.mdc, .cursor/rules/readme.md, .cursor/rules/simple-language.mdc, AGENT.md, CLAUDE.md, docs/AGENT.md"
}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": "llms.txt present",
"points": 15,
"status": "met",
"details": [
{
"code": "llms_txt_present",
"params": {}
}
],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "good",
"name": "Verify loop (build / test / typecheck)",
"note": "Excluded from scoring (no data or not applicable): Demonstrated agent practice. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"demonstrated_agent_practice"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 71,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"uv.lock"
],
"has_dockerfile": true,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": true,
"typecheck_configs": [
"instructor/py.typed"
],
"agent_commit_share": null,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": ".ruff.toml",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".ruff.toml"
}
}
],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "instructor/py.typed",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "instructor/py.typed"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "Dockerfile, lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Dockerfile, lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "dependency automation configured, none observed in the sampled commits",
"points": 5,
"status": "partial",
"details": [
{
"code": "dependency_bot_config_only",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 5",
"points": 5,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 48861,
"source_files_sampled": 542,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python with type-check config (instructor/py.typed)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "instructor/py.typed",
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/542 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 542,
"oversized": 0
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"example_dirs": [
"examples",
"notebooks"
],
"has_mcp_signal": false,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples, notebooks",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples, notebooks"
}
}
],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [],
"report_type": "repository",
"generated_at": "2026-07-18T13:38:20.220088Z",
"schema_version": "0.12.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/i/instructor-ai/instructor.svg",
"full_name": "instructor-ai/instructor",
"license_state": "standard",
"license_spdx": "MIT"
}Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.12.0 — full methodology · metrics wiki.
How one result sits in the wider record: aggregate statistics — PyPI.