https://github.com/trippwill/unum
Container Workload Switcher
https://github.com/trippwill/unum
Last synced: 22 days ago
JSON representation
Container Workload Switcher
- Host: GitHub
- URL: https://github.com/trippwill/unum
- Owner: trippwill
- License: apache-2.0
- Created: 2026-06-22T16:37:32.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-23T16:03:09.000Z (about 1 month ago)
- Last Synced: 2026-06-23T16:16:51.931Z (about 1 month ago)
- Language: Go
- Size: 60.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# unum
[](https://github.com/trippwill/unum/actions/workflows/ci.yml)
Trusted-server local inference manager.
Unum lets a trusted remote terminal control LLM services running on a dedicated
Linux server without exposing container runtime details.
## Current shape
- rootful Fedora Linux + Podman
- one daemon: `unumd`
- SSH TUI control plane
- OpenAI-compatible `/openai/v1/*` inference endpoint with bearer-token auth
- TOML config and profiles
- JSON state for SSH keys and inference tokens
The first planned release tag is **v0.1.0**.
## Development
Install [mise](https://mise.jdx.dev/), then:
```bash
mise install
mise run test
mise run build
```
Useful tasks:
```bash
mise run fmt
mise run vet
mise run precommit
mise run integration-smoke
```
Every commit should be buildable, have passing tests, use Conventional Commits,
and get a rubber duck review first.
## Operations
See [`docs/operations.md`](docs/operations.md) for rootful Fedora+Podman install,
systemd setup, config/profile examples, SSH access, and inference token smoke
checks.
## Product vision
See [`product/vision.md`](product/vision.md). The original release framing in
[`product/unum-v0-product-brief.md`](product/unum-v0-product-brief.md) is
retained as a historical document.