https://github.com/567-labs/instructor

openai openai-function-calli openai-functions pydantic-v2 python validation

Score: 21.290058411175007

Last synced: about 5 hours ago
JSON representation

Repository metadata:

structured outputs for llms

Host: GitHub
URL: https://github.com/567-labs/instructor
Owner: 567-labs
License: mit
Created: 2023-06-14T10:42:23.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2026-08-09T14:55:49.000Z (16 days ago)
Last Synced: 2026-08-18T09:12:15.760Z (7 days ago)
Topics: openai, openai-function-calli, openai-functions, pydantic-v2, python, validation
Language: Python
Homepage: https://python.useinstructor.com/
Size: 75.6 MB
Stars: 13,743
Watchers: 52
Forks: 1,193
Open Issues: 53
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Claude: CLAUDE.md
- Cursor: .cursor/rules/documentation-sync.mdc
Funding:
- Github: jxnl

Owner metadata:

Name: 567-labs
Login: 567-labs
Email:
Kind: organization
Description:
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/152629781?v=4
Repositories: 1
Last Synced at: 2024-05-14T00:11:37.955Z
Profile URL: https://github.com/567-labs

GitHub Events

Total

Create event: 233
Delete event: 262
Fork event: 89
Issue comment event: 581
Issues event: 186
Pull request event: 578
Pull request review comment event: 112
Pull request review event: 350
Push event: 587
Release event: 9
Watch event: 1134
Total: 4121

Last Year

Create event: 113
Delete event: 181
Fork event: 48
Issue comment event: 263
Issues event: 108
Pull request event: 326
Pull request review comment event: 28
Pull request review event: 83
Push event: 261
Release event: 4
Watch event: 526
Total: 1941

Committers metadata

Last synced: 6 days ago

Total Commits: 1,526
Total Committers: 254
Avg Commits per committer: 6.008
Development Distribution Score (DDS): 0.406

Commits in past year: 188
Committers in past year: 42
Avg Commits per committer in past year: 4.476
Development Distribution Score (DDS) in past year: 0.41

Name	Email	Commits
Jason Liu	j**n@j**o	907
Ivan Leo	i**k@g**m	163
David Okpare	o**e@g**m	17
devin-ai-integration[bot]	1****]	15
shreya w	4****1	12
dependabot[bot]	4****]	9
Cursor Agent	c**t@c**m	8
Anmol Jawandha	a**6@g**m	7
Ezzeri Esa	e**a@g**m	7
Francisco Ingham	2****m	7
Sonal Saldanha	s****l	7
Jeongyoon Moon	j**m@u**u	6
Joschka Braun	4****n	6
Matthew	m**0@g**m	6
Daaniyaan	d**1@g**m	5
Lakshya Agarwal	l**l@m**a	5
NicolasPllr1	n**1@g**m	5
Chris Ruppelt	c**1@g**m	4
Hongnan Gao	9****n	4
Jason Liu	j**u@o**m	4
José Londoño	4****o	4
Mohd Waqar Azim	1****3	4
Thomas Dybdahl Ahle	1****l	4
inn-0	1****0	4
lazyhope	7****e	4
mikemikimike	1**7@1**m	4
Ashank Tomar	t**k@g**m	4
Raduan A.	3****n	3
Max Muoto	m**o@g**m	3
Kyle Wilson	7****g	3
and 224 more...

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 116
Total pull requests: 421
Average time to close issues: 25 days
Average time to close pull requests: 8 days
Total issue authors: 89
Total pull request authors: 120
Average comments per issue: 1.49
Average comments per pull request: 1.33
Merged pull request: 111
Bot issues: 0
Bot pull requests: 90

Past year issues: 52
Past year pull requests: 196
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 14 days
Past year issue authors: 44
Past year pull request authors: 96
Past year average comments per issue: 1.71
Past year average comments per pull request: 1.37
Past year merged pull request: 25
Past year bot issues: 0
Past year bot pull requests: 20

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/567-labs/instructor

Top Issue Authors

jxnl (11)
johnwlockwood (5)
truecallerabreham (4)
ivanleomk (3)
lntutor (2)
dmastylo (2)
ErenAta16 (2)
Mr-Ruben (2)
OscarGarciaF (2)
mimran-khan (2)
maxw1489 (2)
ferhimedamine (2)
aum-wmcginnis (1)
hwong557 (1)
spenpal (1)

Top Pull Request Authors

jxnl (126)
dependabot[bot] (55)
devin-ai-integration[bot] (35)
ivanleomk (22)
tonycoder-hub (13)
truecallerabreham (5)
dogonthehorizon (5)
lntutor (5)
jxnl-oai (5)
Solaris-star (4)
feiiiiii5 (4)
Kropiunig (4)
oegedijk (3)
DaveOkpare (3)
mikemikimike (3)

Top Issue Labels

bug (28)
enhancement (21)
python (12)
question (8)
help wanted (8)
documentation (6)
status:needs-investigation (4)
anthropic (4)
priority:critical (2)
type:docs-outdated (2)
dependencies (2)
duplicate (1)
size:L (1)
type:regression (1)
good first issue (1)
status:pending-merge (1)

Top Pull Request Labels

python (155)
enhancement (91)
dependencies (84)
size:M (80)
documentation (75)
bug (28)
codex (25)
size:L (20)
size:S (8)
anthropic (5)
size:XS (2)
experimental (2)
lgtm (1)
size:XXL (1)
priority:critical (1)
status:needs-investigation (1)

Package metadata

Total packages: 2
Total downloads:
- conda: 503 total
Total dependent packages: 0 (may contain duplicates)
Total dependent repositories: 0 (may contain duplicates)
Total versions: 17

proxy.golang.org: github.com/567-labs/instructor

Homepage:
Documentation: https://pkg.go.dev/github.com/567-labs/instructor#section-documentation
Licenses: mit
Latest release: v1.15.4 (published about 2 months ago)
Last Synced: 2026-08-24T12:45:24.672Z (1 day ago)
Versions: 15
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 4.794%
- Average: 4.955%
- Dependent repos count: 5.116%

anaconda.org: instructor

Instructor is a Python library that provides a simple and efficient way to create structured outputs for large language models (LLMs). It allows you to define the structure of the output you want from the LLM, making it easier to work with the generated text. The library is designed to be easy to use and integrate into your existing projects.

Homepage: https://python.useinstructor.com
Licenses: MIT
Latest release: 1.15.1 (published 3 months ago)
Last Synced: 2026-08-08T02:10:53.845Z (18 days ago)
Versions: 2
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 503 Total
Rankings:
- Dependent packages count: 45.594%
- Average: 47.86%
- Dependent repos count: 50.126%

Dependencies

.github/workflows/ty.yml actions

actions/checkout v3 composite
astral-sh/setup-uv v4 composite

.github/workflows/oss-issue-deduplicator.yml actions

actions/checkout v5 composite
openai/codex-action 5c3f4ccdb2b8790f73d6b21751ac00e602aa0c02 composite

.github/workflows/mutation.yml actions

actions/checkout v6 composite
actions/upload-artifact v6 composite
astral-sh/setup-uv 08807647e7069bb48b6ef5acd8ec9567f424441b composite

.github/workflows/oss-issue-tagger.yml actions

actions/checkout v5 composite
openai/codex-action 5c3f4ccdb2b8790f73d6b21751ac00e602aa0c02 composite

requirements.txt pypi

aiohappyeyeballs ==2.6.1
aiohttp ==3.13.5
aiosignal ==1.4.0
annotated-doc ==0.0.4
annotated-types ==0.7.0
anyio ==4.12.1
attrs ==26.1.0
certifi ==2026.2.25
charset-normalizer ==3.4.7
click ==8.3.1
distro ==1.9.0
docstring-parser ==0.17.0
frozenlist ==1.8.0
h11 ==0.16.0
httpcore ==1.0.9
httpx ==0.28.1
idna ==3.11
jinja2 ==3.1.6
jiter ==0.14.0
markdown-it-py ==3.0.0
markupsafe ==3.0.3
mdurl ==0.1.2
multidict ==6.7.1
openai ==2.31.0
propcache ==0.4.1
pydantic ==2.12.5
pydantic-core ==2.41.5
pygments ==2.20.0
regex ==2026.7.19
requests ==2.32.5
rich ==14.3.3
shellingham ==1.5.4
sniffio ==1.3.1
tenacity ==9.1.2
tqdm ==4.67.3
typer ==0.23.2
typing-extensions ==4.15.0
typing-inspection ==0.4.2
urllib3 ==2.6.3
yarl ==1.22.0

uv.lock pypi

248 dependencies

examples/logfire/requirements.txt pypi

instructor ==1.0.3
logfire ==0.28.0
openai ==1.24.1
pydantic ==2.7.1

requirements-examples.txt pypi

aiohttp *
cohere *
datasets *
docstring-parser *
openai >=1.1.0
pre-commit ==4.3.0
pydantic *
rich *
ruff ==0.15.10
trafilatura *
typer *

pyproject.toml pypi

aiohttp <4.0.0,>=3.9.1
docstring-parser <1.0,>=0.16
eval-type-backport >=0.2.2 ; python_version < '3.10'
jinja2 <4.0.0,>=3.1.4
jiter >=0.6.1,<0.15
openai >=2.0.0,<3.0.0
pydantic <3.0.0,>=2.8.0
pydantic-core <3.0.0,>=2.18.0
regex >=2023.0.0,<2027.0.0
requests <3.0.0,>=2.32.3
rich <15.0.0,>=13.7.0
tenacity <10.0.0,>=8.2.3
typer <1.0.0,>=0.9.0

examples/citation_with_extraction/Dockerfile docker

python 3.10-slim-bullseye build

examples/logfire-fastapi/requirements.txt pypi

fastapi ==0.110.3
instructor ==1.0.3
logfire *
logfire ==0.28.0
openai ==1.24.1
pydantic ==2.7.1
uvicorn *

examples/chain-of-density/requirements.txt pypi

instructor *
nltk *
openai *
pydantic *
rich *

requirements-doc.txt pypi

cairosvg *
mkdocs *
mkdocs-jupyter *
mkdocs-llmstxt *
mkdocs-minify-plugin *
mkdocs-redirects *
mkdocstrings *
mkdocstrings-python *
pillow *

examples/citation_with_extraction/requirements.txt pypi

fastapi *
instructor *
openai >=1.0.0
pydantic *
regex *
uvicorn *

.github/workflows/test_docs.yml actions

actions/checkout v2 composite
actions/setup-python v4 composite
astral-sh/setup-uv v4 composite
snok/install-poetry v1.3.1 composite

.github/workflows/ruff.yml actions

actions/checkout v3 composite
actions/upload-artifact v4 composite
astral-sh/ruff-action v3 composite
astral-sh/setup-uv v4 composite

.github/workflows/evals.yml actions

actions/checkout v2 composite
astral-sh/setup-uv v4 composite

.github/workflows/scheduled-release.yml actions

actions/checkout v4 composite
astral-sh/setup-uv v3 composite
ncipollo/release-action v1 composite

.github/workflows/test.yml actions

actions/checkout v2 composite
astral-sh/setup-uv v4 composite

.github/workflows/python-publish.yml actions

actions/checkout v2 composite
astral-sh/setup-uv v4 composite

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Summary