Repository navigation
Releases
CloutFox 3.1.2
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.
![]() |
![]() |
| Settings: the update check, sound, warm-up, backups. | Profiles, folders and the update bar above the list. |
Download
| System | Download |
|---|---|
| Windows 10, 11 | |
| Windows, for admins | |
| Windows, portable | |
| Ubuntu 22.04+, Debian 12+, Mint | |
| Fedora, RHEL 9+, openSUSE | |
| Any Linux | |
| Source code |
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, orchmod +x CloutFox-*.AppImageand 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
SHA256SUMSand starts the installer: the Inno setup on Windows,aptordnfthrough 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 withapt upgradeanddnf 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
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.
![]() |
![]() |
| Folders in the rail: drag a profile onto one. | Settings: sound, warm-up, extensions, backups and diagnostics. |
Download
| System | Download |
|---|---|
| Windows 10, 11 | |
| Windows, for admins | |
| Windows, portable | |
| Ubuntu 22.04+, Debian 12+, Mint | |
| Fedora, RHEL 9+, openSUSE | |
| Any Linux | |
| Source code |
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, orchmod +x CloutFox-*.AppImageand 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
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 | |
| Windows, for admins | |
| Windows, portable | |
| Ubuntu 22.04+, Debian 12+, Mint | |
| Fedora, RHEL 9+, openSUSE | |
| Any Linux | |
| Source code |
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, orchmod +x CloutFox-*.AppImageand 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%\CloutFoxon Windows and in~/.local/share/cloutfoxon 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 inCLOUTFOX_HOME; the builds,run.shandrun_cloutfox.batcall it.CLOUTFOX_HOMEcan also be set in.env.- Errors that stop the app from starting go to
logs/crash.login 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_LANGand 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+Kcommand palette and the/,Nand 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, MCPwarm_up_profileandwarmup_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, awireguardfield 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, MCPlist_extensions, anextensionsfield 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, MCPlaunch_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.








