Skip to main content

// Section 14.4 · Operate

The Command Surface

1 min14.4Operate
CODELINES 19
parallelix-node <command> [options]

  setup                       Guided onboarding: hardware detect, Ollama check, model pull,
                              key gen, staking link, nodeId auto-detect, service install offer.
                              Idempotent: re-running resumes.
  probe                       Detect hardware + Ollama; print the tier it maps to
  init [--wallet 0x..]        Generate the node key + config; print nodeKeyHash (--force overwrites)
  models [pull <name>]        List local Ollama models, or pull one
  models catalog              List the curated model catalog with VRAM requirements
  models recommend            Recommend the largest model fitting 90% of VRAM (50% RAM on CPU)
  start [--node-id <id>]      Run the daemon: attach, heartbeat (uptime), serve inference, return PoE
        [--gpu|--cpu] [--model m] [--plain]
  service [--node-id <id>]    Install as a background service (systemd/launchd): 24/7, auto-restart
        [--gpu|--cpu]
  update                      Check for a new version, verify sha256, atomic swap; aborts on mismatch
  verify                      Run diagnostics; print remediation hints
  status                      Print local node state (address, nodeKeyHash, tier, contracts)
  logs                        Tail the node log (~/.parallelix/node.log)
  version                     Print the binary version

--node-id is optional on start and service once nodeId is saved to config (by setup or manually). --plain on start forces line output (no TTY dashboard); used automatically under systemd/pipes.

Each command is documented with synopsis, flags, what it does, and example output in the CLI Command Reference tutorial (Part XVII).