Add TurboAPI framework [Python + Zig] by justrach · Pull Request #10902 · TechEmpower/FrameworkBenchmarks

justrach · 2026-03-19T12:12:27Z

New Framework: TurboAPI

Language: Python 3.14t (free-threaded, no GIL)
HTTP Core: Zig 0.15 native server (24-thread pool)
Tests: json, plaintext

What is TurboAPI?

TurboAPI is a drop-in FastAPI replacement that moves the entire HTTP layer (TCP, parsing, routing, JSON serialization, CORS) into Zig. Python only runs your business logic.

FastAPI-compatible API (@app.get, @app.post, Depends, middleware)
287 tests passing
Zero-alloc response pipeline (stack buffers, single write syscall)
Response caching (body cached after first Python call, subsequent requests skip Python)
Zig-native CORS (pre-rendered headers, 0% overhead)

Test endpoints

Test	URL	Response
JSON	`/json`	`{"message":"Hello, World!"}`
Plaintext	`/plaintext`	`Hello, World!`

Local verification

================================================================================
Verification Summary
--------------------------------------------------------------------------------
| turboapi
|       json          : PASS
|       plaintext     : PASS
================================================================================

Files

frameworks/Python/turboapi/benchmark_config.json
frameworks/Python/turboapi/turboapi.dockerfile
frameworks/Python/turboapi/app.py
frameworks/Python/turboapi/README.md

Docker

Uses uv to install Python 3.14t free-threaded + Zig 0.15 for the native HTTP backend. Builds and runs on both x86_64 and aarch64.

Docker builds with Python 3.14t free-threaded (via uv) + Zig 0.15. Both /json and /plaintext endpoints respond correctly. Known issue: container exits after ~5s due to Linux Zig thread cleanup segfault (tracked in justrach/turboAPI CI). Server responds to requests while alive. Needs investigation before official TFB submission. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

New framework: TurboAPI - Language: Python 3.14t (free-threaded) - HTTP core: Zig 0.15 native server - Tests: json, plaintext - Verified locally: both PASS

remittor · 2026-03-20T11:12:54Z

Great project! I'm looking forward to the results of the tests!

joanhey · 2026-03-20T16:11:57Z

frameworks/Python/turboapi/app.py

+def json_test():
+    return {"message": "Hello, World!"}


For each request, an object mapping the key message to Hello, World! must be instantiated.

https://github.com/TechEmpower/FrameworkBenchmarks/wiki/Project-Information-Framework-Tests-Overview#json-serialization

PD: the bench is about serialize a json object, not to send raw text directly, for that is the plaintext bench.

Here, it's not a string that's returned from the function, but a dictionary. The framework internally serializes the dictionary (a collection of objects) into a byte array.
Example:

FrameworkBenchmarks/frameworks/Python/emmett/app.py

Lines 41 to 45 in a087d02

@app.route()

@service.json

async def json():

return {'message': 'Hello, World!'}

Fixed — added TURBO_DISABLE_CACHE=1 to ensure the dict is created and serialized fresh on every request. No caching.

Thanks for clarifying — yes, it returns a dict that the framework serializes internally. Also disabled response caching to ensure it's fresh per request.

joanhey · 2026-03-20T16:53:18Z

frameworks/Python/turboapi/turboapi.dockerfile

+
+# Bust Docker cache for git clone
+ARG CACHEBUST=1
+RUN git clone --depth 1 --branch main https://github.com/justrach/turboAPI.git . && \


Which version ??

@justrach
For tests to be repeatable, there is no need to specify the repository HEAD!
By the way, the socketify project also abuses this.

Pinned to v1.0.17.

Fixed — both repos now pinned to specific tags (turboAPI v1.0.17, dhi v1.2.1).

joanhey · 2026-03-20T16:53:39Z

frameworks/Python/turboapi/turboapi.dockerfile

+# Bust Docker cache for git clone
+ARG CACHEBUST=1
+RUN git clone --depth 1 --branch main https://github.com/justrach/turboAPI.git . && \
+    git clone --depth 1 https://github.com/justrach/dhi.git /dhi


Which version ??

Pinned to v1.2.1.

joanhey · 2026-03-20T16:54:52Z

Please add yourself to the maintainers in the benchmark_config.json.

So with any change or marked as broken, you will be notified.

Example:

FrameworkBenchmarks/frameworks/Java/quarkus/benchmark_config.json

Lines 1 to 6 in 33531b8

    
           { 
        
             "framework": "quarkus", 
        
             "maintainers": ["franz1981", "Sanne", "geoand"], 
        
             "tests": [ 
        
               { 
        
                 "default": {

joanhey · 2026-03-20T17:02:18Z

frameworks/Python/turboapi/turboapi.dockerfile

+WORKDIR /turboapi
+
+# Bust Docker cache for git clone
+ARG CACHEBUST=1


This is unnecessary !!
When you add the version in Git clone.

- Add maintainers field to benchmark_config.json - Disable response caching (TURBO_DISABLE_CACHE=1) for TFB compliance - Remove unnecessary ARG CACHEBUST - Pin turboAPI to v1.0.17, dhi to v1.2.1 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

justrach and others added 5 commits March 19, 2026 19:14

fix: clean Dockerfile with uv + Python 3.14t + correct .so naming

f790323

fix: rename Dockerfile to turboapi.dockerfile (TFB convention)

ffb601c

fix: add cache-busting ARG to Dockerfile

6edd360

[ci fw-only Python/turboapi] Add TurboAPI framework - Python/Zig HTTP

f606905

New framework: TurboAPI - Language: Python 3.14t (free-threaded) - HTTP core: Zig 0.15 native server - Tests: json, plaintext - Verified locally: both PASS

joanhey suggested changes Mar 20, 2026

View reviewed changes

justrach force-pushed the master branch from fc2c962 to 62e5530 Compare March 20, 2026 18:53

justrach force-pushed the master branch from 62e5530 to 696d7d6 Compare March 20, 2026 19:03

NateBrady23 closed this Mar 24, 2026

	@app.route()
	@service.json
	async def json():
	return {'message': 'Hello, World!'}

Conversation

justrach commented Mar 19, 2026

New Framework: TurboAPI

What is TurboAPI?

Test endpoints

Local verification

Files

Docker

Uh oh!

remittor commented Mar 20, 2026

Uh oh!

joanhey Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

remittor Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

joanhey commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

joanhey Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

joanhey Mar 20, 2026 •

edited

Loading

remittor Mar 20, 2026 •

edited

Loading

joanhey commented Mar 20, 2026 •

edited

Loading

joanhey Mar 20, 2026 •

edited

Loading