zzstoatzz.io
prefect server in zig
update readme - link to python impl, remove drift-prone lists
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+10
-21
+10
-21
README.md
+10
-21
README.md
···
1
1
# prefect-server
2
2
3
-
zig implementation of prefect server - single binary, ~5x faster than python.
4
-
5
-
## what works
6
-
7
-
- flow/flow_run/task_run lifecycle
8
-
- blocks (types, schemas, documents)
9
-
- variables
10
-
- events (websocket ingest, persistence, broadcast with backfill)
11
-
- dual database backends (sqlite, postgres)
12
-
- dual message brokers (memory, redis)
3
+
zig implementation of [prefect server](https://github.com/prefecthq/prefect) - single binary, ~10x faster than python.
13
4
14
-
see `ROADMAP.md` for detailed implementation status.
5
+
supports sqlite/postgres for storage and memory/redis for messaging. see [ROADMAP.md](ROADMAP.md) for implementation status.
15
6
16
7
## usage
17
8
18
9
```bash
19
-
just --list # show available commands
20
10
just dev # build and run with debug logging
11
+
just test # run api tests against local server
12
+
just docker-test # build and test in docker
21
13
just bench-compare # benchmark against python server
22
14
```
23
15
24
-
requires [zig 0.15](https://ziglang.org/) and [just](https://github.com/casey/just).
16
+
requires [zig 0.15](https://ziglang.org/) and [just](https://github.com/casey/just). run `just --list` for all commands.
17
+
18
+
## testing
19
+
20
+
integration tests use the official [prefect python client](https://github.com/prefecthq/prefect) to validate API compatibility. see [`scripts/`](scripts/) for test harnesses.
25
21
26
22
## configuration
27
23
28
-
| env var | default | description |
29
-
|---------|---------|-------------|
30
-
| `PREFECT_SERVER_PORT` | 4200 | server port |
31
-
| `PREFECT_DATABASE_BACKEND` | sqlite | sqlite or postgres |
32
-
| `PREFECT_BROKER_BACKEND` | memory | memory or redis |
33
-
| `PREFECT_SERVER_LOGGING_LEVEL` | INFO | DEBUG, INFO, WARNING, ERROR |
34
-
35
-
see `docs/` for backend configuration details.
24
+
see [`docs/`](docs/) for configuration details.