Choose the components you need: the local Runtime CLI, the Desktop UI, and/or the Browser Runtime extension. The Runtime CLI is the native host component; the Desktop UI controls it through the local bridge; the browser extension adds browser automation.
After installation, you can access and manage the AI agent through OpenAI ChatGPT here: Open the Flushnet ChatGPT agent.
Current validated native Runtime CLI/Desktop host release. Runtime 1.2.4 includes the unified Access Code, Connect v2 and MCP OAuth policy plus the current Browser VM/MCP helper payloads.
Windows Runtime CLI 1.2.4 (.exe) Windows portable 1.2.4 (.zip) macOS Runtime CLI 1.2.4 (.zip) Runtime 1.2.4 SHA-256
Validated production hashes: macOS 255c9484510843396b9bc9a1a2987132cd5b71da6a8d992600b8733fc97fb0c1, Windows portable 87063c659f3f0f58ba0cc005bb288f1c143df4e25af56980094276bce5636433, Windows EXE adca084248477add76d25792c76df1df1c68017de44e4b2418290a91b71aab31.
All-in-one installers:
Windows all-in-one installer Recommended macOS Safe Installer macOS all-in-one DMG Portable all-in-one bundle
1) Download and install Runtime CLI 1.2.4
2) Open the Desktop UI
3) Connect AI Runner with Connect v2 (recommended), Access Code, or MCP OAuth
4) Press StartWindows fallback: if policy blocks the EXE, use the PowerShell installer.
Download Windows PowerShell installer (.ps1)
macOS certificate-free install: the Safe Installer verifies the published SHA-256, removes quarantine only from Flushnet targets, applies a local ad-hoc signature, and does not disable Gatekeeper globally.
curl -fsSL https://www.flushnet.net/api/downloads/install-macos-safe.sh | /bin/bashValidated Rust local-access runtime for Windows x64 and macOS universal. It uses the canonical local port 7001; if a compatible Flushnet runtime already owns that port, vNext exits cleanly and does not stop, replace, or migrate the existing runtime. Connect v2 and Access Code registration are supported.
Windows x64 vNext (.exe) macOS universal vNext (.dmg) macOS universal binary vNext 0.1.4 SHA-256 vNext release metadata
Validated hashes: Windows x64 956838e216f60c4121a9b11692e534941dc2e6a75543f40215b64b4c279915b0, macOS universal binary 342cb36e38ae169bc6dd56e06dbfe5d7857006a5e8136e94b8ea58a3c7cebf45, macOS DMG f48b4574c67cada0263df2ac9870c77839047edaf9441dae436557df49644ba1.
The hosted Desktop UI remains the continuously updated interface. The native 1.2.6 desktop packages provide the local runtime, bridge and packaged Native Messaging host and open the hosted UI through 127.0.0.1:8765.
Open Hosted Desktop UI Windows native 1.2.6 (.exe) Windows portable 1.2.6 (.zip) macOS universal 1.2.6 (.dmg)
Windows 1.2.6 SHA-256 ยท macOS 1.2.6 SHA-256
Validated 1.2.6 hashes: macOS DMG 575a565794a6d576b1dfd56a625868034834eb4965fb5a6756abb3253a787f64, Windows portable be0e5d92a4bc3b861c11c55c0ccbdad51b6c564dcefb6ceaefa32e1ccb7254a2, Windows EXE b15679cdaa2988b0d60d32f79fade663d43fff2f9a71b2167e37dca467d5f61f.
Native Messaging security: File Tool access requires the packaged FlushnetRuntimeLauncher native host and a rotating five-minute local session token; unauthenticated localhost shell/file execution is disabled.
Certificate-free distribution: the Windows EXE is not Authenticode-signed and may trigger Unknown publisher/SmartScreen. The macOS app is ad-hoc signed rather than Developer ID/notarized and may require explicit Gatekeeper approval on first launch. Verify the published SHA-256 before running.
Run Ubuntu as a normal standalone Flushnet AI Runner machine node. The Linux runtime uses the same native node registration, heartbeat, job queue, shell, file and process control contract as the Windows and macOS runtime. Supported CPU families: x86_64/amd64 and arm64/aarch64.
CLI/headless: suitable for servers, workstations, VMs and machines without a graphical desktop. Desktop UI: installs the same native runtime plus a Linux application-menu launcher for the continuously updated hosted Flushnet Desktop UI.
Ubuntu CLI installer 1.2.6 (.sh) Ubuntu CLI package (.tar.gz) Ubuntu Desktop UI installer 1.2.6 (.sh) Ubuntu Desktop package (.tar.gz) Ubuntu 1.2.6 SHA-256
User-level installation: defaults to ~/.local/share/flushnet-runtime. The installer creates the flushnet-ai-runner CLI and an optional systemd --user service; it does not require a root-owned Flushnet daemon. The runtime can be linked with the same Flushnet account/access flow used by other native nodes.
# CLI / headless Ubuntu runtime
curl -fsSL https://www.flushnet.net/api/downloads/install-ubuntu-cli.sh | bash
flushnet-ai-runner configure
flushnet-ai-runner start
flushnet-ai-runner status
# Ubuntu Desktop UI runtime
curl -fsSL https://www.flushnet.net/api/downloads/install-ubuntu-desktop.sh | bash
flushnet-ai-runner uiOptional autostart after the node is linked: systemctl --user enable --now flushnet-ai-runner.service. Browser-profile binaries are optional; use the CLI installer with --with-browser when a Linux node needs its own Playwright Chromium runtime.
The Browser Runtime extension adds browser automation. Chrome Web Store installation is recommended for managed browser updates; the direct package below is the newest validated manual package.
Open Chrome Web Store Download Browser Runtime 0.4.6 (.zip) 0.4.3 SHA-256
0.4.3 SHA-256: aff1d898a69392df7733175f02ef74b78307a89751d52355d7774e8b530555cb.
After installation, use Connect AI Runner, Access Code, or MCP OAuth according to your runtime/account flow.
Native Messaging: with Native Desktop Runtime 1.2.6, local File Tool requests are delegated through the packaged FlushnetRuntimeLauncher native host. A separate Node.js proxy command is not required for this path; local access uses rotating five-minute session tokens.
Install the native runtime for Windows, macOS or Ubuntu/Linux, open either the hosted or downloadable Desktop UI where available, connect with Connect v2, Access Code, or MCP OAuth, then start and manage the runtime. The web UI and native runtime are separate; Electron is not required.