Install on macOS
Install AgentNet, create the machine identity, start the local console, and optionally enable private networking.
July 2026Requirements
- macOS with an administrator account
- Node.js 20 or newer
- A terminal and internet access for package installation
Install and initialize
PM2 keeps the local router and web console running.
sudo npm install -g pm2Install the current global package.
sudo npm install -g @decentnetwork/lanRun this as your normal user. The identity is stored in your home directory.
agentnet initThis privileged helper manages the optional virtual interface and starts at boot.
sudo agentnet service installDo not run `agentnet init` with sudo. Root and your normal account have different home directories and would create different identities.
Start the router and desktop console
pm2 start "agentnet proxy router --listen 127.0.0.1:8889" --name agentnet-router
pm2 start "agentnet ui --listen 127.0.0.1:8765" --name agentnet-ui
pm2 saveOpen http://localhost:8765. The local smart proxy listens at 127.0.0.1:8889. China split routing is the default; other destinations remain direct unless you change the mode.
Point your browser at the proxy
The router listens at 127.0.0.1:8889. Open a separate Chrome that uses Beagle — your normal Chrome stays untouched, and the separate --user-data-dir is required. China-classified sites go through the exits; everything else stays direct.
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
--proxy-server="127.0.0.1:8889" \
--user-data-dir="/tmp/chrome-beagle" \
--proxy-bypass-list="<-loopback>"Or install the ZeroOmega or FoxyProxy extension and add an HTTP proxy at 127.0.0.1 port 8889. Want every site through the exits? Start the router with agentnet proxy router --all.
Verify the installation
agentnet identity show
agentnet doctor
pm2 statusCopy the address shown by `agentnet identity show`, add it from another Beagle or AgentNet identity, and accept the friend request before testing messages or private routes.