Install anz33

There are two ways to get anz33: an application with an icon you click, or a command line tool you type. They are the same program. If you are not sure which you want, take the application.

Not sure which file? /downloads/auto works out what your computer needs and downloads it.

macOS

The app

1. Download the disk image

   Take the Apple Silicon file if your Mac was bought in 2021 or later, and Intel if it is older. Not sure? Click the Apple menu → About This Mac. If the Chip line says M1, M2, M3 or M4, you want Apple Silicon. All downloads.

2. Drag anz33 to Applications

   Double-click the downloaded .dmg and a window opens with the anz33 icon and a shortcut to your Applications folder. Drag one onto the other.

3. Open it

   anz33 appears in the menu bar at the top-right of your screen — not in the Dock, because it is a background service. Click the icon to see whether it is running and to open the dashboard.

The command line tool

curl -fsSL https://anz33.com/install.sh | sh

This works out whether you are on Apple Silicon or Intel, downloads the right build, checks it against the published checksum, and puts it on your PATH. Or use Homebrew, which does the same thing and handles updates:

brew tap AzmxAI/anz33
brew install anz33          # the command
brew install --cask anz33   # the app

Windows

1. Download the installer

   Take x86_64 unless you know you have an ARM machine (a Surface Pro X or a Snapdragon laptop). If you pick wrong, Windows will tell you rather than doing something strange.

2. Run it

   It installs two things: anz33 for the command line, and anz33 tray, the little icon that lives near the clock. It will offer to add anz33 to your PATH and to start at sign-in — both are worth saying yes to.

3. Find the tray icon

   Bottom-right of the screen, possibly behind the ^ arrow. Drag it out of the overflow so it stays visible. Click it to start the router and open the dashboard.

Prefer a terminal? In PowerShell:

irm https://anz33.com/install.ps1 | iex

Or with Scoop:

scoop install https://github.com/AzmxAI/anz33-releases/raw/main/scoop/anz33.json

Linux

The AppImage — one file, nothing to install

chmod +x anz33-*.AppImage
./anz33-*.AppImage

Run with no arguments and it starts the router and opens the dashboard in your browser. Run it with a command and it behaves exactly like the CLI:

./anz33-*.AppImage status

Debian, Ubuntu, Mint

sudo apt install ./anz33_*.deb

Fedora, RHEL, openSUSE

sudo dnf install ./anz33-*.rpm

Both packages install the anz33 command, a desktop entry so anz33 shows up in your application launcher, and the icons that go with it.

Any distribution

curl -fsSL https://anz33.com/install.sh | sh

With Python, on anything

If you already have Python 3.11 or newer:

uv tool install anz33      # or: pipx install anz33

This is also the answer for Alpine and other musl systems, where the prebuilt binary will not run.

Check it worked

anz33 --version
anz33 0.4.1

If your terminal says "command not found", the program is installed but your shell does not know where to look yet. Close the terminal and open a new one. If that does not fix it, see When something is wrong.

Keep it running

The app starts the router for you. If you use the command line and want anz33 to be there every time you log in:

anz33 install

That sets up a login service — launchd on macOS, a systemd user service on Linux — and starts it. anz33 uninstall removes it again. Nothing else about your system is touched.

Verify what you downloaded

Every release publishes a SHA256SUMS file listing a fingerprint for each download. To confirm your copy is exactly what was built:

shasum -a 256 -c SHA256SUMS

You do not have to do this. It is there so that you can.