// Build the TurboAPI Zig native backend. Use when the turbonet extension needs to be recompiled, after changing Zig source files, or when seeing "Native core not available".
| name | turbo-build |
| description | Build the TurboAPI Zig native backend. Use when the turbonet extension needs to be recompiled, after changing Zig source files, or when seeing "Native core not available". |
| disable-model-invocation | true |
| argument-hint | ["--release"] |
uv run --python 3.14t python zig/build_turbonet.py --install $ARGUMENTS
uv run --python 3.14t python -c "from turboapi import turbonet; print(turbonet.hello())"
cd zig && zig fetch --save "https://github.com/justrach/dhi/archive/refs/heads/main.tar.gz"cd zig && zig fetch --save "git+https://github.com/justrach/pg.zig#master"uv python install 3.14tbrew install zig or download from ziglang.org--install: Copy .so into python/turboapi/ (required for dev)--release: ReleaseFast optimizations (for benchmarks/production)Output: python/turboapi/turbonet.{suffix}.so containing:
Run performance benchmarks for TurboAPI. Use when testing performance, checking for regressions, or comparing against FastAPI.
Scaffold Zig-native database routes using pg.zig + TurboPG. Use when adding database-backed CRUD endpoints, custom SQL queries (pgvector, JSONB, full-text search, JOINs, CTEs), or standalone TurboPG usage.
Use TurboPG for standalone Postgres queries. Use when writing database code outside of TurboAPI routes, running migrations, seeding data, or building scripts that talk to Postgres.
Scaffold a new TurboAPI route with handler, model, and tests. Use when adding a new API endpoint, creating a new route, or scaffolding CRUD for a resource.
Run TurboAPI tests. Use when running tests, checking for regressions, or verifying changes.