Aihper
Aihper

Turn any machine into your Node

Install Node, go online with login / pair / join, and it shows up in the Desktop node list.

Node is an optional Linux runtime. You need an Aihper account, or a Desktop or App that can claim the pairing or join code.

Download Desktop firstOpen the Node install guide

  1. Install Node

    Run on the target Linux host (amd64 / arm64 — the script detects architecture):

    One-line install (Linux)
    curl -fsSL https://get.aihper.com/node | sh

  2. Go online — pick one method

    Any one method below brings this Node online. After success it runs in the background; stop with aihper stop.

    Email & password

    Sign in on this machine

    aihper login

    Desktop join code

    Create a code in Desktop → run join on this machine

    aihper join <join code>

    Local pairing code

    Run here to print a code → claim the node in Desktop

    aihper pair

  3. See it on Desktop

    Open Desktop → Node management: the Node should show as online. A short code is optional — only for quick pick/verify in Resources. Default label is the machine hostname; you can rename in Desktop anytime. Tip: run aihper autostart on so it comes back after reboot.

CLI reference

Four layers: binary → account → machine id → process. Day to day, login / pair / join is enough (starts in the background, then exits). Use start after stop, reboot, or login --no-start.

Commands support language aliases

Localized command names are equivalent in the terminal. The switch below only previews how to type them — it does not change the website language.

e.g. both aihper join and aihper 加入 work

Multilingual commands

logout clears the account credential only; the machine id (short code) stays so the next login reclaims the same node. To forget this machine: reset --identity or reset --all.

Everyday

  • aihper loginSign in and start in the background (returns to the shell; name defaults to hostname)
  • aihper pairPrint a pairing code and wait for Desktop to claim it (no password)
  • aihper joinJoin with a Desktop join code and start the node; pass CODE or type at hidden prompt
  • aihper join <join code>One-liner join with CODE and start the node
  • aihper logoutSign out of the account; keep this machine’s id (short code) so the next login matches the same node
  • aihper startStart the process when already logged in (background by default). Needed after power-off/reboot, stop, or login --no-start — not right after login.
  • aihper stopStop the process only; keeps the login credential
  • aihper autostart statusCheck whether start-at-login / boot is enabled
  • aihper autostart onEnable start at login / boot (requires login / pair / join first)
  • aihper autostart offDisable start at login / boot
  • aihper infoFull status map: auth, identity, process, paths
  • aihper whereLocations only: binary path, data dirs, environment (alias: paths)
  • aihper langShow or set UI language (saved in config)
  • aihper logsFollow the log live (recent lines first, then stream)
  • aihper logs -n 200Show last N lines, then keep following
  • aihper logs --oncePrint recent lines only (do not follow)
  • aihper codePrint this machine’s short code for Desktop (alias: shortcode)

Install

Online nodes can also be upgraded from Desktop → Node management.

  • aihper upgradeDownload and replace the latest binary on this host (keeps config). If a node is running, the install script auto-restarts it; set AIHPER_NO_RESTART=1 to skip the restart. Prefer Desktop remote upgrade when online.
  • aihper uninstallRemove the binary
  • aihper uninstall --purgeRemove binary and wipe local config

Troubleshoot

  • aihper doctorDiagnose common problems and suggest one fix
  • aihper reset --authClear account credential only (same as logout; machine id kept)
  • aihper reset --identityClear machine id; next login is treated as a new cloud node
  • aihper reset --allWipe ~/.config/aihper (credential + machine id)

More commands

  • aihper login --name 'lab-1'Optional: set a display name at login (defaults to hostname; or rename later in Desktop)
  • aihper login --no-startSave credentials only, do not go online (e.g. before systemd start)
  • aihper login --foregroundKeep the node in this terminal after login (blocking; for debugging)
  • aihper start --foregroundStart in the foreground (systemd / debug; default start is background)
  • aihper lang zhSet Chinese and save
  • aihper lang enSet English and save
  • aihper lang deSet German and save
  • aihper lang esSet Spanish and save
  • aihper lang ptSet Portuguese and save

Add --yes to skip confirmation on reset / uninstall --purge. If Desktop remotely signs the node out, run login again.

Needs a runnable binary and network access to the API. For production you can login --no-start then manage start --foreground via systemd. Prefer Desktop remote upgrade for online nodes; use local upgrade / re-run the install script when offline.

Tell machines apart by hostname / IP / short code. Prefer Desktop alias. After reboot: aihper autostart on.