In this tutorial, you'll set up a Remote - the controller for your Agent.
Open a terminal and run:
./remote --personality MyController
Like the Agent, the --personality flag creates a separate Node Identity (NID). Your Sentient Identity (SID) — the operator that represents you — can own as many Remote NIDs as you want, alongside any Agents.
Pro Tip
Run both Remote and Agent on the same computer during learning - just use different terminal windows. Once you're comfortable, move to separate devices. The same Sentient owns both NIDs, so you can switch between them without restarting.
First-time startup triggers the Remote birth process:
The Remote gets its own unique Node Identity (NID), separate from any Agents — but owned by the same Sentient as your Agent.
Did You Know?
Even though Agent and Remote are different node types, the birth process is similar. Both generate RSA key pairs for their NID and derive their personality from the public key. Both NIDs land underneath your single Sentient.
After birth, you'll see the main Remote window:
The main area shows available Agents. Since we haven't discovered any yet, it's empty.
Tap the menu icon (☰) to access:
| Menu Item | Purpose |
|---|---|
| Settings | Configuration options |
| Pairing | Manual pairing (QR/NFC) |
| Connection | Connection settings |
| Utilities | Debug and testing tools |
Click Start Discovery or:
The Remote will search for Agents on the local network:
When your Agent is discovered, it appears in the list:
Each Agent entry shows:
| Field | Meaning |
|---|---|
| Icon | Agent's identicon |
| Name | Generated name |
| Address | Network address |
| Signal | Connection strength |
| Trust | Current trust level |
Before pairing, understand the trust levels:
| Level | Name | Description |
|---|---|---|
| Block | — | Refuse all communication |
| Ignore | — | Tracked but no interaction |
| Trust | — | Full operational relationship |
When you first discover an Agent, it starts at Ignore level. You can see each other but not control.
Security Consideration
OctoMY™ never grants trust automatically. You must explicitly set trust level after verifying the node's identity using its identicon.
Before pairing in the next tutorial, verify:
Verify the identicons match what you expect:
The identicon is derived from the Agent's cryptographic key. If it doesn't match, you might be talking to a different Agent.
Pro Tip
Take a screenshot of your Agent's identicon when you first set it up. This makes visual verification much easier when pairing from a different device.
Check that Agent is running:
# On the Agent device
ps aux | grep agent
Check network connectivity:
# Can you ping the Agent?
ping 192.168.1.105
Check firewall:
# Allow UDP on port 8124
sudo ufw allow 8124/udp
Discovery uses UDP broadcast which can be slow on some networks. Try:
If you see unfamiliar Agents:
You now have:
Just like the Agent, this is one Remote out of potentially many. If you later want a second controller (a tablet for the workshop, a phone for the field), repeat this tutorial with a different --personality name. The same Sentient owns all of them, and Identity Switching lets you move between them mid-session.
First connection - Pair your Remote and Agent, then send your first command