rabbit agent is a small program you install on a computer so OS3 can work on it. A computer with rabbit agent installed and paired to your account is called a node. OS3 can then use the files, tools and software already on that machine, with your approval, instead of starting from an empty cloud environment.
rabbit agent runs on Windows, macOS and Linux, and works on machines you own as well as cloud machines you control.
how to connect a computer
- In OS3, open settings → rabbit agents.
- Choose register rabbit agent.
- Pick the computer's system — macOS, Windows or Linux. OS3 guesses it from the browser you are using, so check it matches the machine you are connecting.
- Copy the install command and run it on that computer: in a terminal on macOS or Linux, or in PowerShell on Windows. OS3 plays a short walkthrough of how to do this.
- The computer appears in the list once it has paired.
If you use the OS3 desktop app on macOS or Windows, you do not need the command for that computer: once you sign in, the app installs rabbit agent and connects the computer automatically. To stop it doing this, turn off Connect this computer to OS3 automatically in the app's rabbit OS3 menu. Disconnect this computer from OS3, in the same menu, removes the computer from your account and turns automatic connection off. If it is turned off, you can still connect the computer from settings → rabbit agents in the app, using the install button beside the system choices.
The install command contains a registration token, and tokens expire. If yours runs out before you use it, start the registration again for a fresh one.
give rabbit agent permission on a mac
To see and operate the screen on a Mac, rabbit agent needs two macOS permissions: Accessibility (called device control and data access on newer versions of macOS) and Screen & System Audio Recording.
Each Mac in settings → rabbit agents has a mac permissions line showing what is still missing. Choose grant and the Mac shows the permission prompts; turn rabbit agent on in System Settings, then choose refresh to check again. The Mac has to be awake, unlocked and connected for this to work.
managing your computers
- Edit a computer to change its name or description, so you can tell your machines apart.
- Set a default so OS3 knows where to send work when you have not said which machine to use.
- Delete a computer to unpair it. You can have up to 20 computers registered at once, so delete one before adding another if you reach the limit.
what OS3 can and cannot do on a connected computer
OS3 works primarily through the computer's terminal, using supported local files, tools and commands. It can also open a web page in a browser on the computer to read it, when the page only shows its content after running scripts; that browser starts with no sign-ins. When a task needs a graphical application instead, OS3 can use DLAM to drive the screen, with your permission.
A connected computer is also where your connected apps run and sign in, and it can serve a local model to OS3.
A connected computer has to be on and connected to the internet for OS3 to use it. A task that is running there stops if the machine sleeps or drops off the network.
rabbit agent runs locally. OS3 as a whole is a hybrid system: it also uses rabbit's own services and the model provider you chose. Connecting a computer does not mean rabbit automatically copies that computer or all of its files into the cloud — OS3 works with the computers and relevant files you choose to use for a task.
common questions
can OS3 use more than one computer?
Yes. You can register up to 20 and ask OS3 to use them within the same task or project.
is rabbit agent the same as the OS3 desktop app?
No. The desktop app is OS3 itself in its own window on macOS or Windows. rabbit agent is the separate program that lets OS3 work on a computer. When you sign in to the desktop app, it installs rabbit agent and connects the computer it runs on automatically, unless you turn that off.
can I run a model on my own machine?
Yes. A connected computer can serve a local model to OS3. See how to bring your own key.
how do I remove rabbit agent?
Delete the computer in settings → rabbit agents to unpair it, then uninstall the program on the machine itself.