{
  "project_id": "567-labs/instructor",
  "repo": "567-labs/instructor",
  "name": "instructor",
  "github_url": "https://github.com/567-labs/instructor",
  "homepage_url": "https://python.useinstructor.com/",
  "language": "Python",
  "license": "MIT",
  "project_kind": "project",
  "category": [
    "prompt_tooling"
  ],
  "tags": [
    "openai",
    "openai-function-calli",
    "openai-functions",
    "pydantic-v2",
    "python",
    "validation"
  ],
  "description": "structured outputs for llms ",
  "overview": "Use 567-labs/instructor when the user needs a prompt tooling project with library-only, local, cloud deployment options.",
  "alternatives": [
    {
      "repo": "NVIDIA-NeMo/Guardrails",
      "reason": "Same prompt tooling intent with workflow overlap."
    },
    {
      "repo": "guardrails-ai/guardrails",
      "reason": "Same prompt tooling intent with workflow overlap."
    },
    {
      "repo": "ndcorder/outputguard",
      "reason": "Same prompt tooling intent with workflow overlap."
    }
  ],
  "related": [
    {
      "repo": "hassancs91/SimplerLLM",
      "reason": "Related to 567-labs/instructor through prompt tooling category and library_only deployment."
    },
    {
      "repo": "lennartpollvogt/ollama-instructor",
      "reason": "Related to 567-labs/instructor through prompt tooling category and library_only deployment."
    },
    {
      "repo": "superagent-ai/superagent",
      "reason": "Related to 567-labs/instructor through prompt tooling category and library_only deployment."
    },
    {
      "repo": "arena-ai/structured-logprobs",
      "reason": "Related to 567-labs/instructor through prompt tooling category and library_only deployment."
    },
    {
      "repo": "modelence/modelence",
      "reason": "Related to 567-labs/instructor through prompt tooling category and library_only deployment."
    },
    {
      "repo": "DataFog/datafog-python",
      "reason": "Related to 567-labs/instructor through prompt tooling category and library_only deployment."
    },
    {
      "repo": "ndcorder/outputguard",
      "reason": "Related to 567-labs/instructor through prompt tooling category and library_only deployment."
    },
    {
      "repo": "theopenco/llmgateway",
      "reason": "Related to 567-labs/instructor through prompt tooling category and local deployment."
    }
  ],
  "dependencies": [
    "LLM provider"
  ],
  "deployments": [
    "library_only",
    "local",
    "cloud"
  ],
  "difficulty": "intermediate",
  "cloudflare_ready": false,
  "use_cases": [
    "manage prompts",
    "version prompt workflows",
    "improve prompt iteration"
  ],
  "not_good_for": [
    "edge-only Cloudflare Workers deployment without adaptation",
    "users expecting a complete hosted product"
  ],
  "classification": {
    "category": {
      "confidence": "high",
      "evidence": [
        "Manual product trust override for 567-labs/instructor."
      ]
    },
    "deployment": {
      "confidence": "high",
      "evidence": [
        "Matched \"pip install\" in repository content.",
        "Local usage is assumed for open source repositories unless contradicted."
      ]
    },
    "difficulty": {
      "confidence": "medium",
      "evidence": [
        "No strong beginner or advanced signal found; defaulting to intermediate."
      ]
    },
    "cloudflare_ready": {
      "confidence": "high",
      "evidence": [
        "Runtime blocker: python.",
        "No Cloudflare deployment signal detected.",
        "No wrangler.toml found in inspected repository files."
      ]
    }
  },
  "quality_signals": {
    "stars": 13919,
    "recent_commits": 63,
    "contributors": 100,
    "issue_response_time_hours": null,
    "release_frequency_180d": 6
  },
  "quality_signal_confidence": {
    "stars_30d_delta": "snapshot",
    "stars30d_window_days": 30,
    "commits_30d": "complete",
    "releases_180d": "complete",
    "contributors_90d": "partial"
  },
  "quality_score": 37,
  "agent_score": 81,
  "score": 92,
  "agent_score_breakdown": {
    "documentation": 90,
    "maintenance": 58,
    "deployment": 80,
    "popularity": 83,
    "community": 100
  },
  "git_top_score": 92,
  "git_top_score_breakdown": {
    "community": 100,
    "maintenance": 71,
    "documentation": 84,
    "stability": 100,
    "adoption": 100,
    "agent_readability": 100
  },
  "verification": {
    "schema_version": "git-top.verification.v1",
    "overall_status": "partial",
    "observed_at": "2026-09-19T08:00:38.615Z",
    "signals": {
      "activity": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.pushed_at",
          "metrics.recent_push_days"
        ]
      },
      "license": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.license"
        ]
      },
      "documentation": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.description"
        ]
      },
      "runtime": {
        "status": "inferred",
        "source": "git_top_heuristic",
        "evidence": [
          "agent_card.deployment",
          "agent_card.cloudflare_ready"
        ]
      },
      "install": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "installation/build probe is not enabled"
        ]
      },
      "security": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "dependency/security scan is not enabled"
        ]
      },
      "mcp": {
        "status": "not_applicable",
        "source": "git_top_runtime",
        "evidence": [
          "project is not classified as mcp_server"
        ]
      }
    },
    "coverage": {
      "observed": 3,
      "inferred": 1,
      "not_run": 2,
      "unknown": 0
    },
    "next_steps": [
      "Run an installation/build probe before production adoption.",
      "Run a dependency and security scan before treating the score as a trust claim."
    ]
  },
  "summary": {
    "tl_dr": "Use 567-labs/instructor when the user needs a prompt tooling project with library-only, local, cloud deployment options.",
    "purpose": "Use 567-labs/instructor when the user needs a prompt tooling project with library-only, local, cloud deployment options.",
    "install": "Install as a library or package using the repository instructions.",
    "inputs": [
      "prompt templates",
      "schemas",
      "constraints"
    ],
    "outputs": [
      "structured prompts",
      "validated generations",
      "prompt tooling artifacts"
    ],
    "good_for": [
      "manage prompts",
      "version prompt workflows",
      "improve prompt iteration",
      "structured output",
      "prompt engineering",
      "format enforcement"
    ],
    "not_good_for": [
      "edge-only Cloudflare Workers deployment without adaptation",
      "users expecting a complete hosted product",
      "raw inference serving",
      "database workloads"
    ],
    "deployment": [
      "library_only",
      "local",
      "cloud"
    ],
    "alternatives": [
      {
        "repo": "NVIDIA-NeMo/Guardrails",
        "reason": "Same prompt tooling intent with workflow overlap."
      },
      {
        "repo": "guardrails-ai/guardrails",
        "reason": "Same prompt tooling intent with workflow overlap."
      },
      {
        "repo": "ndcorder/outputguard",
        "reason": "Same prompt tooling intent with workflow overlap."
      }
    ]
  },
  "evidence": {
    "classification": {
      "category": {
        "confidence": "high",
        "evidence": [
          "Manual product trust override for 567-labs/instructor."
        ]
      },
      "deployment": {
        "confidence": "high",
        "evidence": [
          "Matched \"pip install\" in repository content.",
          "Local usage is assumed for open source repositories unless contradicted."
        ]
      },
      "difficulty": {
        "confidence": "medium",
        "evidence": [
          "No strong beginner or advanced signal found; defaulting to intermediate."
        ]
      },
      "cloudflare_ready": {
        "confidence": "high",
        "evidence": [
          "Runtime blocker: python.",
          "No Cloudflare deployment signal detected.",
          "No wrangler.toml found in inspected repository files."
        ]
      }
    },
    "quality_signal_confidence": {
      "stars_30d_delta": "snapshot",
      "stars30d_window_days": 30,
      "commits_30d": "complete",
      "releases_180d": "complete",
      "contributors_90d": "partial"
    },
    "verification": {
      "schema_version": "git-top.verification.v1",
      "overall_status": "partial",
      "observed_at": "2026-09-19T08:00:38.615Z",
      "signals": {
        "activity": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.pushed_at",
            "metrics.recent_push_days"
          ]
        },
        "license": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.license"
          ]
        },
        "documentation": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.description"
          ]
        },
        "runtime": {
          "status": "inferred",
          "source": "git_top_heuristic",
          "evidence": [
            "agent_card.deployment",
            "agent_card.cloudflare_ready"
          ]
        },
        "install": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "installation/build probe is not enabled"
          ]
        },
        "security": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "dependency/security scan is not enabled"
          ]
        },
        "mcp": {
          "status": "not_applicable",
          "source": "git_top_runtime",
          "evidence": [
            "project is not classified as mcp_server"
          ]
        }
      },
      "coverage": {
        "observed": 3,
        "inferred": 1,
        "not_run": 2,
        "unknown": 0
      },
      "next_steps": [
        "Run an installation/build probe before production adoption.",
        "Run a dependency and security scan before treating the score as a trust claim."
      ]
    },
    "source_fields": [
      "project.description",
      "project.topics",
      "project.language",
      "project.license",
      "agent_card.summary_for_agent",
      "agent_card.use_cases",
      "agent_card.deployment",
      "agent_card.classification",
      "metrics",
      "verification.signals"
    ],
    "caveats": [
      "edge-only Cloudflare Workers deployment without adaptation",
      "users expecting a complete hosted product",
      "Partial or estimated quality signals: contributors90d.",
      "Independent installation, security, or runtime probes have not been run for this project."
    ],
    "confidence_reason": "Classification evidence and quality signals are strong enough for shortlist reasoning when metadata is current.",
    "last_verified_at": "2026-09-19T08:00:38.615Z"
  },
  "caveats": [
    "edge-only Cloudflare Workers deployment without adaptation",
    "users expecting a complete hosted product",
    "Partial or estimated quality signals: contributors90d.",
    "Independent installation, security, or runtime probes have not been run for this project."
  ],
  "confidence_reason": "Classification evidence and quality signals are strong enough for shortlist reasoning when metadata is current.",
  "source_fields": [
    "project.description",
    "project.topics",
    "project.language",
    "project.license",
    "agent_card.summary_for_agent",
    "agent_card.use_cases",
    "agent_card.deployment",
    "agent_card.classification",
    "metrics",
    "verification.signals"
  ],
  "last_verified_at": "2026-09-19T08:00:38.615Z",
  "knowledge": {
    "project": {
      "id": "567-labs/instructor",
      "owner": "567-labs",
      "name": "instructor",
      "full_name": "567-labs/instructor",
      "github_url": "https://github.com/567-labs/instructor",
      "homepage_url": "https://python.useinstructor.com/",
      "description": "structured outputs for llms ",
      "language": "Python",
      "topics": [
        "openai",
        "openai-function-calli",
        "openai-functions",
        "pydantic-v2",
        "python",
        "validation"
      ],
      "license": "MIT",
      "stars": 13919,
      "forks": 1253,
      "open_issues": 67,
      "default_branch": "main",
      "created_at": "2023-06-14T10:42:23Z",
      "updated_at": "2026-09-19T07:58:41Z",
      "pushed_at": "2026-09-18T21:58:13Z",
      "synced_at": "2026-09-19T08:00:38.615Z"
    },
    "agent_card": {
      "project_id": "567-labs/instructor",
      "project_kind": "project",
      "category": "prompt_tooling",
      "difficulty": "intermediate",
      "deployment": [
        "library_only",
        "local",
        "cloud"
      ],
      "cloudflare_ready": false,
      "use_cases": [
        "manage prompts",
        "version prompt workflows",
        "improve prompt iteration"
      ],
      "not_good_for": [
        "edge-only Cloudflare Workers deployment without adaptation",
        "users expecting a complete hosted product"
      ],
      "alternatives": [
        {
          "project_id": "NVIDIA-NeMo/Guardrails",
          "reason": "Same prompt tooling intent with workflow overlap."
        },
        {
          "project_id": "guardrails-ai/guardrails",
          "reason": "Same prompt tooling intent with workflow overlap."
        },
        {
          "project_id": "ndcorder/outputguard",
          "reason": "Same prompt tooling intent with workflow overlap."
        }
      ],
      "summary_for_agent": "Use 567-labs/instructor when the user needs a prompt tooling project with library-only, local, cloud deployment options.",
      "classification": {
        "category": {
          "confidence": "high",
          "evidence": [
            "Manual product trust override for 567-labs/instructor."
          ]
        },
        "deployment": {
          "confidence": "high",
          "evidence": [
            "Matched \"pip install\" in repository content.",
            "Local usage is assumed for open source repositories unless contradicted."
          ]
        },
        "difficulty": {
          "confidence": "medium",
          "evidence": [
            "No strong beginner or advanced signal found; defaulting to intermediate."
          ]
        },
        "cloudflare_ready": {
          "confidence": "high",
          "evidence": [
            "Runtime blocker: python.",
            "No Cloudflare deployment signal detected.",
            "No wrangler.toml found in inspected repository files."
          ]
        }
      },
      "schema_version": "v1",
      "generated_at": "2026-09-19T08:00:38.615Z"
    },
    "metrics": {
      "project_id": "567-labs/instructor",
      "stars_30d_delta": 168,
      "commits_30d": 63,
      "releases_180d": 6,
      "contributors_90d": 100,
      "issue_first_response_median_hours": null,
      "recent_push_days": 0,
      "git_score": 37,
      "maintenance_score": 58,
      "signal_confidence": {
        "stars_30d_delta": "snapshot",
        "stars30d_window_days": 30,
        "commits_30d": "complete",
        "releases_180d": "complete",
        "contributors_90d": "partial"
      },
      "calculated_at": "2026-09-19T08:00:38.615Z"
    }
  },
  "resolved_from": {
    "requested_id": "567-labs/instructor",
    "resolved_id": "567-labs/instructor",
    "resolution": "direct"
  },
  "metadata": {
    "source": "d1",
    "reason": "d1_query",
    "project_count": 1213,
    "generated_at": "2026-09-20T12:32:41.489Z",
    "snapshot_id": "d1:1213:2026-09-20T12:31:12.339Z",
    "latest_synced_at": "2026-09-20T12:31:12.339Z",
    "schema_version": "git-top.knowledge.v1",
    "loaded_project_limit": 2000,
    "truncated": false
  }
}