Instructor

structured outputs for llms

LLM Gateways & Infra Python Grade C Listed MIT
Compare → Suggest correction
Listing state
Listed
HVTrust
62.5/100 · Grade C
Evidence coverage
Grade A · 4/5 signals
Last push
2026-07-13 · 6d ago
Recent change
Provider Added +5

Is Instructor safe? Instructor scores 62.5/100 (Grade C), ranked #177 of 418 tracked open-source AI agent projects, on evidence coverage A (4 of 5 independent signal types). The public evidence: no package-provenance attestation found; OSSF Scorecard rates its supply-chain practices 5.2/10; 76% of recent commits are signed; last pushed 2026-07-13. Every point is earned from checkable signals — never paid placement. How scoring works →

Quick Trust Read

Verdict
Promising trust profile, but some evidence still deserves review.
62.5/100 · Grade C
Strongest Signal
Adoption
18.8/20
Weakest Signal
Safety / Integrity
10.3/25
What Would Improve It
Publish package provenance or release attestations for stronger supply-chain evidence.
Recent Changes
2026-07-17
Provider Added
Runtime surface grew — new detected provider dependencies: Cohere, Fireworks AI, Google Gemini, Groq, Mistral AI, Multi-provider (LiteLLM), xAI Grok
2026-07-17
Rank Moved
Rank dropped 14 spots (#161 → #175)
2026-07-15
Rank Moved
Rank dropped 10 spots (#153 → #163)
Maintainer Checklist
Raise Scorecard signals Current OSSF Scorecard is 5.2/10. Tighten the weakest checks to improve public safety evidence.
Publish provenance Add package provenance or release attestations so users can verify where shipped artifacts came from.
71.9
Activity Score · out of 100
62.5
HVTrust Score · out of 100
#177
Global Rank · of 418
#7

How to read this: HVTrust (0–100) weighs supply-chain signals (provenance, OSSF Scorecard, signed commits, open license) alongside real-world adoption. Grade C reflects the trust score band: A ≥ 80, B ≥ 65, C ≥ 50, D < 50. Evidence coverage A is separate — it grades how many independent signal types back the score (4 of 5), so a high score on thin evidence stays visible. Full methodology →

Signals refreshed 2026-07-19 08:02 UTC · Repo last pushed 6 days ago

Rank Trend

2026-07-05 2026-07-19

Activity & Reach

Stars
13.6k
Forks
1.2k
Last Push
2026-07-13
6 days ago
Commits (4 wk)
4?
Downloads (7d)
4,419,525
pypi
HN mentions (30d)
1
Open Issues
23
Rank Change
▼2
was #175

Analysis

HVTrust Dimensions

62.5 / 100 · 100.0% confidence
Safety / Integrity50% OSSF Scorecard · 30% provenance · 20% signed commits
10.3 / 25
Identity / Provenance60% listing status · 40% build provenance
10.8 / 18
Transparency50% declared license · 50% OSSF Scorecard
12.9 / 17
Maintenance60% last-push freshness · 40% commit activity
13.0 / 20
Adoption60% stars · 40% downloads, log-scaled
18.8 / 20

Activity Inputs

71.9 / 100
StarsRepository reach
24.8 / 30
FreshnessLast push recency
24.2 / 25
ActivityRecent commits
8.7 / 25
CommunityFork signal
14.2 / 20

Supply Chain Trust

Package Provenance
None
No package attestations found
OSSF Scorecard
5.2 / 10
OpenSSF Scorecard · scanned Jul 19, 2026
Signed Commits
76%
of last 100 commits verified
Binary-Artifacts 10
Branch-Protection 6
CI-Tests 6
CII-Best-Practices 0
Code-Review 3
Contributors 10
Dangerous-Workflow 10
Dependency-Update-Tool 10
Fuzzing 0
License 10
Maintained 10
Packaging -1
Pinned-Dependencies 5
SAST 0
Security-Policy 0
Signed-Releases -1
Token-Permissions 0
Vulnerabilities 0

Is Instructor safe?

Instructor has a mixed signal profile. Some trust indicators are present, others are missing. Whether it is safe for your use case depends on which gaps matter to you — review the breakdown below before adopting in production.
Does Instructor publish package provenance?
No published build provenance is currently detected for Instructor. This is common for open-source projects but means consumers cannot independently verify that the package on the registry matches the GitHub source.
Does Instructor have an OpenSSF Scorecard?
Instructor has an OpenSSF Scorecard score of 5.2/10. The Scorecard checks for branch protection, signed releases, dependency updates, fuzzing, code review, and other supply-chain hygiene items. See the full check breakdown on this page.
Is Instructor actively maintained?
Actively maintained. The repository was pushed to within the last 6 day(s).
What license does Instructor use?
Instructor ships under MIT. A declared, OSI-approved license is one of the transparency signals HVTrust scores.
Are Instructor's commits signed?
76% of the last 100 commits to Instructor are verified-signed (GPG, SSH, S/MIME, or GitHub's signing flow). Signed commits help confirm that code was authored by who the commit claims.

Not a safety endorsement. HVTracker describes what public signals show, not whether a project is safe for your use case. Run your own security review before adopting in production.

Ranked neighbours in LLM Gateways & Infra

AI agent surface

Scored in HVTrust

These runtime-trust fields — detected from public repo docs and manifests — contribute a bounded adjustment to this project's HVTrust score alongside supply-chain evidence. The exact values each field can add or subtract are documented in the methodology → Compare this surface across every listed agent in the capability matrix →

MCP Server Support
None detected
No MCP server signal detected.
Detailed evidence is not shown in the public view.
External Service Dependencies
high confidence
11 detected
Public provider/service dependencies detected.
Credential signal: No explicit API-key/config marker detected.
Tool / Plugin Surface
medium confidence
1 tags
Broad capability areas detected.
  • database
Detailed evidence is not shown in the public view.
Package Provenance Drift
low confidence
Unknown
Package source metadata is missing or inconclusive
Detailed evidence is not shown in the public view.
  • MCP signal live
  • External deps live
  • Tool / plugin surface live
  • Package provenance drift live
How this surface has changed

Detected changes to Instructor's runtime surface and supply-chain posture, from daily public-signal snapshots. A change here means our detectors see something different — a genuinely changed capability, or better evidence of an existing one.

2026-07-17
Provider Added
Runtime surface grew — new detected provider dependencies: Cohere, Fireworks AI, Google Gemini, Groq, Mistral AI, Multi-provider (LiteLLM), xAI Grok
2026-07-04
Provider Removed
Runtime surface shrank — no longer detected: Google Gemini
2026-06-05
Provider Added
Runtime surface grew — new detected provider dependencies: Amazon Bedrock, Anthropic, Google Gemini, OpenAI, Redis

Maintain Instructor?

HVTrust scores Instructor from public signals only — we never contact maintainers first. If a signal is wrong, stale, or missing (provenance you publish, a Scorecard you run, signed releases), tell us and we'll review it. Corrections are public and tracked on GitHub.

Reputation Timeline

Rank 5Grade 4Surface 2Listed 1HVTrust 1Scorecard 1Surface 1
2026-07-17
Provider Added
Runtime surface grew — new detected provider dependencies: Cohere, Fireworks AI, Google Gemini, Groq, Mistral AI, Multi-provider (LiteLLM), xAI Grok
2026-07-17
Rank Moved
Rank dropped 14 spots (#161 → #175)
2026-07-15
Rank Moved
Rank dropped 10 spots (#153 → #163)
2026-07-14
Grade Changed
Trust grade B → C
2026-07-14
Rank Moved
Rank dropped 23 spots (#130 → #153)
2026-07-13
Grade Changed
Trust grade C → B
2026-07-04
Provider Removed
Runtime surface shrank — no longer detected: Google Gemini
2026-06-18
Rank Moved
Rank dropped 10 spots (#102 → #112)
2026-06-16
Grade Changed
Trust grade C → B
2026-06-14
Grade Changed
Trust grade B → C
2026-06-05
Provider Added
Runtime surface grew — new detected provider dependencies: Amazon Bedrock, Anthropic, Google Gemini, OpenAI, Redis
2026-06-05
Scorecard Added
OSSF Scorecard: 5.0/10
2026-06-03
Rank Moved
Rank rose 26 spots (#194 → #168)
2026-06-03
HVTrust Changed
HVTrust up 17.4pts (23.8 → 41.2)
2026-06-02
Newly Listed
First tracked at rank #194

Embed Badge Badge guide for maintainers →

HVTrust 62.5 Grade C
Markdown:
[![HVTrust](https://hvtracker.net/badge/instructor.svg)](https://hvtracker.net/agents/instructor)
HTML:
<a href="https://hvtracker.net/agents/instructor"><img src="https://hvtracker.net/badge/instructor.svg" alt="HVTrust"></a>

Other agents in LLM Gateways & Infra

Data sources
GitHub REST API (repo, commits, stars, forks, license) · PyPI / pypistats (downloads, provenance) · OpenSSF Scorecard CLI · Algolia HN Search API
Each agent's signals refresh once daily across 6 staggered batches. Methodology v4.2 · Raw JSON