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

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

Score: 14.853887940533578

Last synced: about 24 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 (over 2 years ago)
Default Branch: main
Last Pushed: 2026-01-24T01:21:44.000Z (11 days ago)
Last Synced: 2026-01-24T11:35:26.829Z (11 days ago)
Topics: openai, openai-function-calli, openai-functions, pydantic-v2, python, validation
Language: Python
Homepage: https://python.useinstructor.com/
Size: 73.1 MB
Stars: 12,203
Watchers: 52
Forks: 918
Open Issues: 78
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: 2 months ago

Total Commits: 1,425
Total Committers: 230
Avg Commits per committer: 6.196
Development Distribution Score (DDS): 0.404

Commits in past year: 335
Committers in past year: 58
Avg Commits per committer in past year: 5.776
Development Distribution Score (DDS) in past year: 0.496

Name	Email	Commits
Jason Liu	j**n@j**o	849
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
Anmol Jawandha	a**6@g**m	7
Cursor Agent	c**t@c**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
dependabot[bot]	4****]	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
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
Phodaie	p**e@g**m	3
Kyle Kelley	r**k@g**m	3
and 200 more...

Issue and Pull Request metadata

Last synced: about 1 month 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)

Dependencies

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/pyright.yml actions

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

.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