What you need
- A Mac, Linux box, WSL2, or Raspberry Pi.
- Node.js 20 or newer.
- A provider key (OpenAI or Anthropic) — or none if you use Ollama.
Install
$ curl -fsSL https://remoteagent.online/install.sh | bash
Log in and add a key
- Run
remoteagent loginand open the printed link. - In the dashboard, open Settings → API keys.
- Add your OpenAI or Anthropic key. It is encrypted in the vault.
- Or skip this and run Ollama locally — no key needed.
Start and chat
$ remoteagent start
$ remoteagent chat "what does this machine look like?"
Next steps
Create a named agent, set a token budget, and give it a device. Then read the tutorials for the deeper setup — sandboxing, cron jobs, and the audit trail.
If something breaks
i
Run
remoteagent doctor. It checks the install, the environment, and the connection to the control plane, and tells you what to fix.