Karti Tripathi
75aa63d737
ci / rust (push) Successful in 2m26s
Governed compute for unified-memory AI hardware — the machines where CPU and GPU share one pool and there is no separate VRAM allocation to bounce off. Over-commit that pool and the box thrashes and wedges, SSH and ping included, before the OOM killer gets a turn. Compute does not run inference. It supervises the servers that do: - Admission control against two ceilings: a declared budget, and what the machine actually has free. The refusal is the feature. - A 1 Hz watchdog on MemAvailable that stops the newest model before thrash, and defers to a Scene transition rather than racing it. - Scenes: named sets of models activated as one transactional unit, with pre-flight validation and rollback to the previously active Scene on failure. Scenes reference model ids, never weight paths or commands, so a Scene obtained from elsewhere cannot introduce code. - Process ownership bound to (boot_id, pid, start_time_ticks, pgid == pid), so a reused PID can never be group-killed. - A protocol-transparent TCP gateway, so clients keep one address while model runtimes move behind it. - An MCP server, so agents drive the node as tools rather than as a CLI. One binary, no async runtime outside the MCP surface. Apache-2.0. Generated from the internal monorepo by scripts/publish-compute.sh, which refuses to publish a tree it cannot prove clean.
21 lines
623 B
Markdown
21 lines
623 B
Markdown
# Contributing to Lumbridge Compute
|
|
|
|
Contributions are welcome. Changes land as small, reviewable commits.
|
|
|
|
## Development
|
|
|
|
```bash
|
|
cargo test
|
|
cargo fmt --check
|
|
cargo clippy --all-targets
|
|
cargo build --release
|
|
```
|
|
|
|
Changes to the `lumbridge/v1` scene or eval contracts require fixtures, backward-
|
|
compatibility notes, and documentation. Never add secrets, private model tokens,
|
|
personal voice samples, internal hostnames, or arbitrary commands to shareable
|
|
scene/eval manifests.
|
|
|
|
Performance changes should include before/after JSON artifacts and the complete
|
|
hardware/model/runtime configuration needed to reproduce them.
|