MacOS Remote Client

Installations

Homebrew

Install the Unify Desktop Assistant CLI from our Homebrew tap:

brew install --HEAD unifyai/unifyai/unify-desktop-assistant

Local Setup

Watch this video for local setup.

1. Add the required environment variables, then install the required dependencies

unify-desktop-assistant add-env UNIFY_KEY <your-key-value>

unify-desktop-assistant add-env ANTHROPIC_API_KEY <your-key-value>

unify-desktop-assistant add-env UNIFY_BASE_URL https://api.unify.ai/v0

unify-desktop-assistant install

2. Create a user profile for the agent with the following details:

Username: <AGENT_NAME_FIRST_LAST>

Password: <UNIFY_KEY>

3. Start the remote client app.

unify-desktop-assistant start

4. Tunnel the service to HTTPS.

a. For testing

• Start the tunnel. A URL for testing will be provided.

unify-desktop-assistant tunnel

b. For production - WIP

• Login to Cloudflare. This is a one time step.

cloudflared tunnel login

• Start the tunnel.

TUNNEL_HOSTNAME=<prod_hostname> TUNNEL_NAME=<prod_appname> unify-desktop-assistant tunnel

Live Remote Viewing and Controls

1. Tunnel the remote view.

unify-desktop-assistant liveview

2. View and control the desktop through the URL below. When prompted for username and password, use the details above.

<cloudflared-url>/vnc.html?resize=scale&autoreconnect=1&autoconnect=1

Troubleshooting

• Make sure ANTHROPIC_API_KEY, UNIFY_BASE_URL and UNIFY_KEY are in your .env file when starting the service.
• When running with Actor, make sure UNIFY_KEY and at least [email protected] are present in your unity .env for the magnitude server auth to work.