hey-api /hey-api
👨🚀 Turn API specifications into production-ready SDKs, validators, mocks, and more. 20+ plugins. Millions of weekly npm downloads. Used by Vercel, OpenCode, PayPal, AWS, Autodesk, and many more.
★ 5,585⑂ 457👁 11⑃ 2,733● 1,604▤ 422
+3
日增长
5,585
stars
457
forks
11
watchers
2,733
prs
1,604
issues
422
releases
README
Hey API
"OpenAPI codegen that just works."— Guillermo Rauch, CEO of Vercel
Manual
•
Issues
•
Contribute
About
Hey API is an ecosystem for turning API specifications into production-ready code. It's trusted by thousands of companies – from YC startups to Fortune 500 enterprises – and powers products used by millions worldwide.
This is the monorepo containing all open source Hey API packages. For package-specific documentation and quick start guides, see the individual repositories below.
Packages
Package
Description
openapi-ts
TypeScript code generator with 20+ plugins for SDKs, Zod schemas, TanStack Query hooks, and more.
Manual
•
npm
openapi-python
Python code generator for SDKs and Pydantic models.
Manual
•
npm
Highlights
- production-grade code that compiles
- runs in any Node.js 22+ environment
- accepts any OpenAPI specification
- core plugins for SDKs
- HTTP clients for Fetch API, Axios, Angular, Next.js, Nuxt, HTTPX, and more
- Zod schemas, TanStack Query hooks, Pydantic models, and 20+ plugins to reduce third-party boilerplate
- highly customizable via plugins
Libraries
Package
Description
spec-types
TypeScript definitions for OpenAPI and JSON Schema specifications with complete inline documentation.
npm
Contributing
Want to see your code in products used by millions?
Start with our Contributing guide and release your first feature.
Sponsors
Partners behind the future of API tooling. Become a sponsor.
Gold
The open source coding agent.
opencode.ai
Silver
fastapi.tiangolo.com
getunblocked.com
Bronze
License
Released under the MIT License.Top issues
#558Transform case for generated types37 comments · 2024-05-12#586Got client33 comments · 2024-05-16#4235TypeScript 7 support (solution)23 comments · 2026-07-09#3778Support `x-enum-descriptions` in `@hey-api/typescript` with `enums: false`23 comments · 2026-04-15#495Allow easy differentiation by status codes22 comments · 2024-04-25#2040Custom queryKey generation for @tanstack/react-query plugin21 comments · 2025-05-14#1074Big int for Format int6420 comments · 2024-09-21#1020Option to ignore headers19 comments · 2024-09-05
Discussions
#4315Update @hey-api/json-schema-ref-parser with js-yaml 4.3.1 to resolve CVE finding0 comments · 2026-08-05#4277Why are there so many @ts-expect-errors in the file generated on my side?0 comments · 2026-07-22#4180TanStack Start dev server fails with NitroViteError: Vite environment "ssr" is unavailable after running @hey-api/openapi-ts1 comments · 2026-06-29#4140Large OpenAPI specs, generated SDK (Vue) typecheck cost, and the path to TypeScript 7.10 comments · 2026-06-22#3918Any way to serialize date and date-time formats differently in the request body?2 comments · 2026-05-20#3871Is there a native enum (z.nativeEnum) support for zod pluggin?2 comments · 2026-05-13#3854Is it possible to anyhow customize Zod's messages?2 comments · 2026-05-07#3712Why is my `openapi-ts.config.ts` file wrong?1 comments · 2026-04-06
Latest release
Jun 22nd, 2026 2026-06-22 2026-06-22@hey-api/openapi-ts 0.99.0 ⚠️ Breaking This release has 4 breaking changes. Please review the release notes carefully before upgrading. Updates - parser: delete unresolvable $ref keywords (4087) - api: replace ~ fields with $ (4086) - client: use getBaseUrl() function to determine default value (3772) - ⚠️ Breaking: config: merge duplicate plugin configurations Plugin duplicates behavior If you specified the same plugin multiple times, only the last instance would be used. We eventually added a warning for this behavior, but that didn't treat the root issue. This releas