create-hayate 0.3.0

Scaffold tested Hayate API, Cloudflare Workers, and MCP 2025-11-25 projects

create-hayate

API, Cloudflare Workers, and MCP 2025-11-25 project scaffolding for hayate — uvx create-hayate my-app and you have a running, tested project in minutes.

uvx create-hayate my-app --template workers
cd my-app
uv run pytest        # green out of the box
uv run python manage_workers.py dev

Templates

Name	What you get	Serve with
api (default)	TODO API + tests that call the app core directly	uv run uvicorn app:app --reload
workers	The same app on Cloudflare Python Workers	uv run python manage_workers.py dev / deploy
mcp	MCP 2025-11-25 server shared by ASGI and Workers	Uvicorn or manage_workers.py

The mcp template uses the Workers-native, schema-validated hayate-mcp runtime on both platforms. It does not require hayate-auth: connect an existing identity provider through request context, or add the authorization server package when the application owns authentication.

Design

• Zero-dependency CLI (stdlib only: argparse + string.Template), templates bundled in the package — no network fetch, works offline, version-pinned.
• Templates mirror the upstream examples/ style, and CI generates every template and runs its test suite, so they can't rot.
• The Workers template pins Python 3.13 and Node.js 24 to the versions used by workerd/Pywrangler, and its launcher fails fast on an unsupported Node runtime instead of producing an incomplete dependency bundle.
• Generated projects use the Hayate 0.11 compatibility line. Workers uploads exclude caches, package metadata, ASGI/AWS adapters, and the WSGI bridge while retaining uts46 for complete internationalized URL behavior.
• WorkerEntrypoint remains the feature-complete default. HTTP-only services can explicitly select the lower-overhead global compatibility path with --workers-entrypoint global; it cannot expose named RPC methods or class handlers such as scheduled.
• One question at most (the template); --no-input for scripts and CI.

The internal design memo (Japanese, per project convention) lives in DESIGN.md; release history is in CHANGELOG.md.

Status: alpha (0.3.x). Generated API, Workers, and MCP projects are exercised in CI against their real dependency resolution and test suites.

License

MIT