zzstoatzz.io
prefect server in zig
clean up README
- remove endpoint listing (see ROADMAP.md for details)
- add what works section with broad feature overview
- point to justfile for commands
- add configuration table
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+25
-16
README.md
+25
-16
README.md
···
1
1
# prefect-server
2
2
3
-
minimal prefect server in zig - single binary, sqlite storage.
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)
13
+
14
+
see `ROADMAP.md` for detailed implementation status.
4
15
5
-
## build & run
16
+
## usage
6
17
7
18
```bash
8
-
zig build && ./zig-out/bin/prefect-server
19
+
just --list # show available commands
20
+
just dev # build and run with debug logging
21
+
just bench-compare # benchmark against python server
9
22
```
10
23
11
-
server runs on `localhost:4200`.
24
+
requires [zig 0.15](https://ziglang.org/) and [just](https://github.com/casey/just).
12
25
13
-
## endpoints
14
-
15
-
- `POST /flows/` - create/get flow by name
16
-
- `POST /flow_runs/` - create flow run
17
-
- `GET /flow_runs/{id}` - read flow run
18
-
- `POST /flow_runs/{id}/set_state` - transition state
19
-
- `POST /flow_runs/filter` - list flow runs
20
-
- `GET /health` - health check
26
+
## configuration
21
27
22
-
## test
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 |
23
34
24
-
```bash
25
-
./scripts/test-flow-sequence
26
-
```
35
+
see `docs/` for backend configuration details.