ByoWorker class

Constructors

ByoWorker({String? arch, List<String> capabilities = const [], String? cpuModel, int? cpus, String? cuda, String? driver, EngineAdvertisement? engine, String? firstSeen, List<ByoGPU> gpus = const [], String? hip, String? hostname, String? id, String? jobQueue, String? lastHeartbeat, String? location, int? memory, String? os, String? provider, String? rocm, String? status, String? version})

Returns a new ByoWorker instance.

Properties

arch ↔ String?

Arch/CPUs/Memory are the connecting host's static CPU spec, mirrored from the registration: Arch is runtime.GOARCH (amd64 | arm64), Memory is total RAM in BYTES — the same fields a code-linked run-target carries, so the /v1/visor/fleet board renders a linked node's arch + cores + RAM like any other unit.

getter/setter pair

capabilities ↔ List<String>

Capabilities is what this worker offers the org: "studio.render" when the node can render, "engine.serve" when it serves a model endpoint. A node advertises one only once it can honour it, so an absent list means a node that has dialed in but is not ready to serve any of them yet.

getter/setter pair

cpuModel ↔ String?

CPUModel is the processor as the host names it ("Apple M3 Max"), for display.

getter/setter pair

cpus ↔ int?

CPUs is the host's logical core count.

getter/setter pair

cuda ↔ String?

Cuda is the host's CUDA toolkit version. NVIDIA hosts report it.

getter/setter pair

driver ↔ String?

Driver is the host's NVIDIA kernel driver version — distinct from Cuda, and the one that bounds which CUDA versions can run on this box.

getter/setter pair

engine ↔ EngineAdvertisement?

Engine is the hanzo-engine model server this node runs, when it runs one (hanzo link --serve-engine). Absent means the node takes jobs but serves no model endpoint.

getter/setter pair

firstSeen ↔ String?

FirstSeen is when this node first dialed in, RFC 3339 — the start of its presence record, which hanzo unlink ends.

getter/setter pair

gpus ↔ List<ByoGPU>

GPUs are the accelerators the host found on itself. Empty is a real answer: a CPU-only machine can dial in and take non-GPU work.

getter/setter pair

hashCode → int

The hash code for this object.

no setter, override

hip ↔ String?

Hip is the host's HIP runtime version, the AMD counterpart to Cuda.

getter/setter pair

hostname ↔ String?

Hostname is what the host calls itself. It equals ID for any hostname already in the a-z0-9- alphabet, and differs when sanitizing had to change it.

getter/setter pair

id ↔ String?

ID is the node's id in the fleet — the sanitized hostname it registered under, which is also the unit its samples and its gpu-jobs lane key on. This is the id to use everywhere else on the compute surface.

getter/setter pair

jobQueue ↔ String?

JobQueue is the tasks NAMESPACE this worker claims render jobs out of — "gpu-jobs" unless hanzo link was pointed at another. Within it, a job aimed at this node alone rides the task-queue value "gpu:

getter/setter pair

lastHeartbeat ↔ String?

LastHeartbeat is the most recent beat this node sent, RFC 3339. It is what Status is computed from, so a reader can check the judgement.

getter/setter pair

location ↔ String?

Location is always "on-prem" — a machine that dialed in has no cloud region, and inventing one would put it somewhere it is not.

getter/setter pair

memory ↔ int?

Memory is the host's total RAM in BYTES.

getter/setter pair

os ↔ String?

Os is the host's operating system: linux, darwin or windows.

getter/setter pair

provider ↔ String?

Provider is always "byo": this machine is the operator's, not one Hanzo provisioned. It exists so a fold into the machines/GPUs pages says which rows are rented and which are the customer's own.

getter/setter pair

rocm ↔ String?

Rocm is the host's ROCm version. AMD hosts report it; empty otherwise.

getter/setter pair

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

status ↔ String?

Status is "online" when the last heartbeat landed within 90s, else "offline" — so it is a fact about heartbeat freshness, not about the box being powered on. A worker that has never beaten reads offline.

getter/setter pair

version ↔ String?

Version is the hanzo CLI version running on the node. It is what to check when a worker is missing a field a newer registration reports.

getter/setter pair

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toJson() → Map<String, dynamic>

toString() → String

A string representation of this object.

override

Operators

operator ==(Object other) → bool

The equality operator.

override

Static Methods

fromJson(dynamic value) → ByoWorker?

Returns a new ByoWorker instance and imports its values from value if it's a Map, null otherwise.

listFromJson(dynamic json, {bool growable = false}) → List<ByoWorker>

mapFromJson(dynamic json) → Map<String, ByoWorker>

mapListFromJson(dynamic json, {bool growable = false}) → Map<String, List<ByoWorker>>

Constants

requiredKeys → const Set<String>

The list of required keys that must be present in a JSON.