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

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

Score: 21.21767453744647

Last synced: about 15 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 (almost 3 years ago)
Default Branch: main
Last Pushed: 2026-05-20T14:39:54.000Z (11 days ago)
Last Synced: 2026-05-21T16:44:27.968Z (10 days ago)
Topics: openai, openai-function-calli, openai-functions, pydantic-v2, python, validation
Language: Python
Homepage: https://python.useinstructor.com/
Size: 73.3 MB
Stars: 12,996
Watchers: 54
Forks: 1,050
Open Issues: 42
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
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

Committers metadata

Last synced: 4 days ago

Total Commits: 1,495
Total Committers: 250
Avg Commits per committer: 5.98
Development Distribution Score (DDS): 0.407

Commits in past year: 282
Committers in past year: 52
Avg Commits per committer in past year: 5.423
Development Distribution Score (DDS) in past year: 0.397

Name	Email	Commits
Jason Liu	j**n@j**o	886
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
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
Ashank Tomar	t**k@g**m	4
Raduan A.	3****n	3
Max Muoto	m**o@g**m	3
Kyle Wilson	7****g	3
Richard Stromer	n****n	3
adriaan	l**e@g**m	3
and 220 more...

Issue and Pull Request metadata

Last synced: 5 months ago

Total issues: 76
Total pull requests: 252
Average time to close issues: 9 days
Average time to close pull requests: 4 days
Total issue authors: 58
Total pull request authors: 31
Average comments per issue: 1.13
Average comments per pull request: 1.35
Merged pull request: 99
Bot issues: 0
Bot pull requests: 82

Past year issues: 76
Past year pull requests: 252
Past year average time to close issues: 9 days
Past year average time to close pull requests: 4 days
Past year issue authors: 58
Past year pull request authors: 31
Past year average comments per issue: 1.13
Past year average comments per pull request: 1.35
Past year merged pull request: 99
Past year bot issues: 0
Past year bot pull requests: 82

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

Top Issue Authors

jxnl (10)
johnwlockwood (5)
ivanleomk (3)
maxw1489 (2)
OscarGarciaF (2)
dmastylo (2)
Noudhombergh (1)
Dseal95 (1)
scpedicini (1)
anmolsood21 (1)
hwong557 (1)
aum-wmcginnis (1)
spenpal (1)
TwilightSpar (1)
Mr-Ruben (1)

Top Pull Request Authors

jxnl (108)
dependabot[bot] (47)
devin-ai-integration[bot] (35)
ivanleomk (22)
dogonthehorizon (5)
oegedijk (3)
DaveOkpare (3)
Gable-github (2)
workwithpurwarkrishna (2)
yanomaly (2)
indigoviolet (2)
eaedk (2)
phlogisticfugu (1)
jeongyoonm (1)
pnkvalavala (1)

Top Issue Labels

bug (22)
enhancement (15)
question (8)
python (8)
help wanted (6)
documentation (4)
anthropic (3)
dependencies (2)
good first issue (1)
duplicate (1)

Top Pull Request Labels

python (144)
enhancement (89)
size:M (78)
dependencies (76)
documentation (75)
bug (26)
size:L (20)
codex (20)
size:S (8)
anthropic (5)
size:XS (2)
experimental (2)
lgtm (1)
size:XXL (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: 15

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

Homepage:
Documentation: https://pkg.go.dev/github.com/567-labs/instructor#section-documentation
Licenses:
Latest release: v1.15.1 (published about 2 months ago)
Last Synced: 2026-04-29T16:02:21.097Z (about 1 month ago)
Versions: 13
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 5 days ago)
Last Synced: 2026-05-27T10:10:54.195Z (4 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

pyproject.toml pypi

aiohttp <4.0.0,>=3.9.1
diskcache >=5.6.3
docstring-parser <1.0,>=0.16
jinja2 <4.0.0,>=3.1.4
jiter >=0.6.1,<0.12
openai >=2.0.0,<3.0.0
pre-commit >=4.3.0
pydantic <3.0.0,>=2.8.0
pydantic-core <3.0.0,>=2.18.0
requests <3.0.0,>=2.32.3
rich <15.0.0,>=13.7.0
tenacity <10.0.0,>=8.2.3
ty >=0.0.1a23
typer <1.0.0,>=0.9.0

.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

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 *

requirements-doc.txt pypi

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

requirements-examples.txt pypi

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

requirements.txt pypi

aiohappyeyeballs ==2.6.1
aiohttp ==3.13.1
aiosignal ==1.4.0
annotated-types ==0.7.0
anyio ==4.11.0
attrs ==25.4.0
certifi ==2025.10.5
cfgv ==3.5.0
charset-normalizer ==3.4.4
click ==8.1.8
diskcache ==5.6.3
distlib ==0.4.0
distro ==1.9.0
docstring-parser ==0.17.0
filelock ==3.19.1
frozenlist ==1.8.0
h11 ==0.16.0
httpcore ==1.0.9
httpx ==0.28.1
identify ==2.6.15
idna ==3.11
jinja2 ==3.1.6
jiter ==0.11.1
markdown-it-py ==3.0.0
markupsafe ==3.0.3
mdurl ==0.1.2
multidict ==6.7.0
nodeenv ==1.9.1
openai ==2.6.1
platformdirs ==4.4.0
pre-commit ==4.4.0
propcache ==0.4.1
pydantic ==2.12.3
pydantic-core ==2.41.4
pygments ==2.19.2
pyyaml ==6.0.3
requests ==2.32.5
rich ==14.2.0
shellingham ==1.5.4
sniffio ==1.3.1
tenacity ==9.1.2
tqdm ==4.67.1
ty ==0.0.1a27
typer ==0.20.0
typing-extensions ==4.15.0
typing-inspection ==0.4.2
urllib3 ==2.5.0
virtualenv ==20.35.4
yarl ==1.22.0

.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

examples/logfire/requirements.txt pypi

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

.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

examples/citation_with_extraction/Dockerfile docker

python 3.10-slim-bullseye build

.github/workflows/test.yml actions

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

examples/citation_with_extraction/requirements.txt pypi

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

.github/workflows/python-publish.yml actions

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

.github/workflows/ai-label.yml actions

actions/checkout v4 composite
jlowin/ai-labeler v0.4.0 composite

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

instructor *
nltk *
openai *
pydantic *
rich *

uv.lock pypi

244 dependencies

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Summary