Skip to content

Releases

CloutFox 3.1.2

Choose a tag to compare

@github-actions github-actions released this 15 Nov 23:39

CloutFox: open-source anti-detect profiles

CloutFox 3.1.2: a free, open-source anti-detect browser profile manager on Camoufox. Every profile gets its own fingerprint, cookies, proxy or WireGuard tunnel, timezone and language. AI agents drive the profiles through MCP and the REST API. No subscription, no cloud: your data stays on your computer.

What's new in 3.1.2

Updates arrive by themselves. The first start asks once whether CloutFox may look for a newer version; after that it asks GitHub at most once a day and a bar above the list says when one is out. "Install update" downloads the release, checks its SHA-256 against SHA256SUMS and starts the installer: the Windows setup, apt or dnf behind the system password prompt, or the AppImage replaces itself in place. The switch and the manual check are in Settings.

apt and dnf repositories. Debian, Ubuntu, Fedora and openSUSE can take CloutFox from software.cloutlab.studio; from then on apt upgrade and dnf upgrade bring new versions with the rest of the system. The indexes and the packages are signed with the CloutFox packages key.

A stuck profile starts again. A failed stop could leave a browser holding a profile, and every later launch of it failed with an unreadable error. The launcher now takes the whole process tree of a runner with it.

What is in CloutFox

Settings: updates, warm-up, extensions, backups Profiles with folders in the rail
Settings: the update check, sound, warm-up, backups. Profiles, folders and the update bar above the list.

Download

System Download
Windows 10, 11 Installer
Windows, for admins MSI
Windows, portable Portable
Ubuntu 22.04+, Debian 12+, Mint deb
Fedora, RHEL 9+, openSUSE rpm
Any Linux AppImage tar.gz
Source code Source

x86_64 only. Checksums: SHA256SUMS.

First start

  • Camoufox downloads once on the first launch (about 700 MB); the progress is in the Activity Log.
  • Windows SmartScreen: the builds are not code-signed yet. Click "More info" → "Run anyway".
  • Install commands: sudo apt install ./cloutfox_3.1.2_amd64.deb, sudo dnf install ./cloutfox-3.1.2-1.x86_64.rpm, or chmod +x CloutFox-*.AppImage and run it.
  • AI agents: while CloutFox runs, claude mcp add --transport http cloutfox http://127.0.0.1:8000/mcp.

Full guide: README · По-русски: README.ru.md

Everything in 3.1.2

Added

  • Updates in the app: after the first-start question, CloutFox asks GitHub once a day for a newer version and shows a bar above the profile list with "Install update". The button downloads the release file, checks its SHA-256 against SHA256SUMS and starts the installer: the Inno setup on Windows, apt or dnf through the polkit password prompt on Linux, and a running AppImage is replaced in place. Settings → About keeps the manual check; Settings → Interface holds the switch for the automatic one. Nothing about the computer is sent, and CloutFox never replaces itself silently.
  • apt and dnf repositories on GitHub Pages at software.cloutlab.studio: on a published release a new workflow builds the indexes, signs them with the packages key and deploys the site, so Debian, Ubuntu, Fedora and openSUSE users get new versions with apt upgrade and dnf upgrade.

Fixed

  • A failed stop or a killed app could leave a browser holding the profile, and every later launch then failed with an unreadable error. On Linux the launcher now kills the runner's whole process tree, the browser included.

CloutFox 3.1.1

Choose a tag to compare

@github-actions github-actions released this 15 Nov 22:05

CloutFox: open-source anti-detect profiles

CloutFox 3.1.1: a free, open-source anti-detect browser profile manager on Camoufox. Every profile gets its own fingerprint, cookies, proxy or WireGuard tunnel, timezone and language. AI agents drive the profiles through MCP and the REST API. No subscription, no cloud: your data stays on your computer.

What's new in 3.1.1

Folders. Profiles live in folders up to three levels deep: a tree in the rail with counts, drag a row onto a folder, or "Move to folder" in the row menu and in the bulk bar. An empty folder stays until you delete it; deleting one moves its profiles one level up and never deletes a profile.

Diagnostics for support. Settings → About saves a ZIP with the version, logs, process list, settings and the panel's own numbers, and opens the data folder. No passwords, proxies, cookies, WireGuard configs or tokens.

Windows. Stopping a profile waits for a clean close, an encrypted profile is packed with retries, a deleted profile leaves no files behind, no console windows flash, and the local proxy bridge serves only your own user of the computer. The panel reports its memory, reloads a window that never came up, and says so after a crash.

What is in CloutFox

Profiles with folders in the rail Settings, where diagnostics are saved
Folders in the rail: drag a profile onto one. Settings: sound, warm-up, extensions, backups and diagnostics.

Download

System Download
Windows 10, 11 Installer
Windows, for admins MSI
Windows, portable Portable
Ubuntu 22.04+, Debian 12+, Mint deb
Fedora, RHEL 9+, openSUSE rpm
Any Linux AppImage tar.gz
Source code Source

x86_64 only. Checksums: SHA256SUMS.

First start

  • Camoufox downloads once on the first launch (about 700 MB); the progress is in the Activity Log.
  • Windows SmartScreen: the builds are not code-signed yet. Click "More info" → "Run anyway".
  • Install commands: sudo apt install ./cloutfox_3.1.1_amd64.deb, sudo dnf install ./cloutfox-3.1.1-1.x86_64.rpm, or chmod +x CloutFox-*.AppImage and run it.
  • AI agents: while CloutFox runs, claude mcp add --transport http cloutfox http://127.0.0.1:8000/mcp.

Full guide: README · По-русски: README.ru.md

Everything in 3.1.1

The app is the same as 3.1.0, whose release was stopped by the Arch install check. Everything below came in 3.1.0; the last bullet is the CI fix.

Added

  • Folders: put profiles into folders up to three levels deep, drag a row onto a folder in the rail, or use "Move to folder" in the row menu and in the bulk bar. An empty folder stays until you delete it; deleting one moves its profiles one level up. Folders travel with a ZIP export, and the API filters with GET /profiles?folder=.
  • Settings → About: save a diagnostics archive (version, logs, process list, settings, the panel's own numbers) with one button and open the data folder. No passwords, proxies, cookies, WireGuard configs or tokens go into it.
  • The panel now says how heavy it is: the renderer's heap, node count and scaling go into the log, a window that never comes up is reloaded twice and logged, and after a renderer crash the panel says so instead of starting silently over.

Fixed

  • Windows: deleting a tree clears the read-only attribute and retries a file another process holds, so a deleted or replaced profile no longer leaves files behind.
  • Windows: packing an encrypted profile retries after a stop, and a failed pack keeps the newer unpacked copy instead of deleting it.
  • Windows: stopping a profile waits 15 seconds for a clean close instead of 2, so a heavy profile saves its tabs.
  • Windows: the cookie tool and the browser runner no longer flash a console window from the installed app.
  • Windows: the proxy bridge refuses connections from another OS account, as it already did on Linux.
  • Panel: a renderer that keeps dying reloads with a growing delay, at most five times.
  • Security: profile data folders and the files with proxies and keys are read-only for their owner (0700 and 0600), not for every user of the machine.
  • The Arch install check in the release workflow upgrades the whole container (pacman -Syu) instead of single packages, so a rolling Arch no longer stops a release.

Changed

  • The checks run on every pushed branch, not only on main.
  • The committed panel is rendered in a browser on every push: the profile list, the folder tree, the command palette, screenshots at two window sizes.
  • Windows CI launches an encrypted profile with a Cyrillic name twice through a real browser and checks that its container is repacked, its tabs are kept and no process or unpacked folder is left.

CloutFox 3.0.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 17:20

CloutFox: open-source anti-detect profiles

CloutFox 3.0.0: a free, open-source anti-detect browser profile manager on Camoufox. Every profile gets its own fingerprint, cookies, proxy or WireGuard tunnel, timezone and language. AI agents drive the profiles through MCP and the REST API. No subscription, no cloud: your data stays on your computer.

Download

System Download
Windows 10, 11 Installer
Windows, for admins MSI
Windows, portable Portable
Ubuntu 22.04+, Debian 12+, Mint deb
Fedora, RHEL 9+, openSUSE rpm
Any Linux AppImage tar.gz
Source code Source

x86_64 only. Checksums: SHA256SUMS.

First start

  • Camoufox downloads once on the first launch (about 700 MB); the progress is in the Activity Log.
  • Windows SmartScreen: the builds are not code-signed yet. Click "More info" → "Run anyway".
  • Install commands: sudo apt install ./cloutfox_3.0.0_amd64.deb, sudo dnf install ./cloutfox-3.0.0-1.x86_64.rpm, or chmod +x CloutFox-*.AppImage and run it.
  • AI agents: while CloutFox runs, claude mcp add --transport http cloutfox http://127.0.0.1:8000/mcp.

Full guide: README · По-русски: README.ru.md

Everything in 3.0.0

The first release: https://github.com/cloutlab-studio/cloutfox

Added

  • Ready-made builds: exe and msi installers and a zip for Windows; deb and rpm packages, an AppImage, a tar.gz and an AUR recipe for Linux. Python and every dependency are bundled, so there is nothing to install first. Data lives in %LOCALAPPDATA%\CloutFox on Windows and in ~/.local/share/cloutfox on Linux.
  • Camoufox downloads on first launch, with progress in the log; a Camoufox profile waits for the download and then starts on its own. Only one process downloads at a time.
  • cloutfox_app.py: starts the app from any folder on any OS with data in CLOUTFOX_HOME; the builds, run.sh and run_cloutfox.bat call it. CLOUTFOX_HOME can also be set in .env.
  • Errors that stop the app from starting go to logs/crash.log in the data folder (the Windows app has no console to show them).
  • English and Russian interface. It follows the system language (Russian on a Russian system, English everywhere else); CLOUTFOX_LANG and the switch in the panel override it.
  • GitHub Actions checks on Linux and Windows: ruff, pytest, the panel and the browser stop on Windows. A release tag builds every package, installs each one on a clean system (Debian, Ubuntu, Fedora, openSUSE, Arch, Windows) and opens a draft release with SHA256SUMS.
  • A panel in the Brutal style of the Cloutlab studio: a Qt WebEngine window (pywebview) with a Svelte interface. Pages for Profiles, Activity Log, AI agents and Settings, the profile editor next to the list, a Ctrl+K command palette and the /, N and Space keys, a ticker with running profiles, toasts with results, and the whole profile list without paging.
  • Panel sounds (launch, stop, error, end of a warm-up or backup, an agent's request) and animations; Settings → Interface holds sound, volume, animation, cursor and language. The chosen language is remembered.
  • Confirmation before removing a WireGuard tunnel, decrypting a profile, clearing the self-destruct password and removing an extension.
  • Cookie warm-up: a profile visits a random part of the shared site list (or its own list) like a person, then closes. Row menu ⋮ → "Warm up cookies", a "Warm up" button for selected profiles, the site list in Settings, a counter in the profile's row, POST/GET /browser/{name}/warmup, MCP warm_up_profile and warmup_status.
  • WireGuard for a profile in place of a proxy (through wireproxy 1.1.3, downloaded on first use and checked by SHA-256): row menu ⋮ → "WireGuard", "Check IP" through the tunnel, PUT/DELETE /profiles/{name}/wireguard, a wireguard field on the profile.
  • Launching through a WireGuard tunnel into a private network with no internet exit: CloutFox recognizes such a tunnel by AllowedIPs, does not look for an exit IP, switches WebRTC off and skips the geo check. The timezone and language must be pinned.
  • Browser extensions: a shared folder, a choice per profile, GET /extensions, MCP list_extensions, an extensions field on the profile. An extension belongs to an engine (Camoufox or Chrome): a profile sees and loads only its own, and the API refuses the others.
  • The "Refuse a launch on geo mismatch" setting: before a launch the exit IP is checked against Cloudflare, ipinfo and ip-api.
  • Scheduled backups to a chosen folder, encrypted with a master password; restore with python -m src.services.backup restore. The self-destruct password deletes them too.
  • For agents: one-time profiles (POST /browser/temp, MCP launch_temp_profile), a per-profile log of agent actions, a request for human help (request_human) with a card in the app, one action in several profiles (browser_broadcast).
  • Optional encryption: a master password with a sign-in screen and a recovery key (encrypts profiles.json, backups and profile keys), profile data encryption with the master password and/or a profile password, a self-destruct password.
  • Settings in the side panel.
  • Tags, status, notes, start pages and an IP change link per profile; filters by tag and status, search by tags and notes.
  • The profile's row shows the time of the last launch, the exit IP and the country.
  • "Many profiles": from a name template with a proxy pool, or from a list of name;proxy;tags;note.
  • "Edit selected": proxies, status and tags in bulk. Cloning a profile from the row menu.
  • REST: POST /profiles/bulk, /profiles/import-list, /profiles/proxies, /profiles/{name}/clone, /profiles/{name}/rotate-ip, ?tag= and ?status= filters. MCP: create_profiles_bulk, clone_profile, set_proxies, rotate_proxy_ip.
  • An agent's request for help brings the CloutFox window to the front and keeps it on top until you answer, covers the panel with a card holding the request and plays a chime.
  • On Linux the local proxy bridge accepts only programs of your own OS user. The WireGuard tunnel's proxy has a password, and the browser reaches it through the bridge. Proxy passwords never appear on the browser's command line, which every user of the computer can see.
  • Camoufox profiles with a password-protected SOCKS5 proxy: the browser connects to a local bridge without a password, and the bridge signs in to the proxy.
  • Windows: stopping a profile closes the browser cleanly, saves the tabs and packs an encrypted profile after the browser has closed.