id: 4a1f6926-a591-55ab-94d7-5abbfdd3d6db

Flowpad

A local-first AI development environment powered by Claude Code. Run AI-assisted workflows directly on your machine with full control over your data.

Install

Desktop App (recommended)

Download the latest release for your platform:

Platform	Download
macOS (Apple Silicon & Intel)	Flowpad-universal.dmg
Windows	Flowpad-Setup.exe
Linux (AppImage)	Flowpad-x64.AppImage
Linux (deb)	Flowpad-x64.deb
Linux (rpm)	Flowpad-x64.rpm

The desktop app handles everything automatically — no Python or other dependencies required. On first launch it installs the backend from PyPI and starts it for you.

Linux AppImage

chmod +x Flowpad-x64.AppImage
./Flowpad-x64.AppImage

Python Package (CLI)

Install Flowpad as a command-line tool. Requires Python 3.10+.

Using uv (recommended)

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install flowpad
uv tool install flowpad

# Start the server
flow start

Using pipx

# Install pipx if you don't have it
python3 -m pip install --user pipx

# Install flowpad
pipx install flowpad

# Start the server
flow start

Using pip

pip install flowpad

# Install a specific version
pip install flowpad==0.2.0

This starts the Flowpad server at http://localhost:9007 and opens it in your browser.

Upgrade

# Using uv
uv tool upgrade flowpad

# Using pipx
pipx upgrade flowpad

# Using pip
pip install --upgrade flowpad

CLI Commands

Command	Description
`flow`	Print version
`flow start`	Start the server (background, with auto-restart)
`flow stop`	Stop the server
`flow status`	Show server status
`flow setup <agent>`	Setup Flowpad for a coding agent (e.g. `claude-code`)
`flow trace`	Start server and trace hook events in real-time
`flow hooks set`	Install Flow hooks into Claude Code settings
`flow hooks list`	List configured hooks
`flow hooks clear`	Remove Flow hooks from Claude Code settings
`flow config list`	List configuration values
`flow config set key=value`	Set a configuration value
`flow auth login`	Login to Flowpad (opens browser or accepts API key)
`flow auth logout`	Logout and remove stored credentials
`flow ping <string>`	Send a test ping to the local server

Uninstall

# Using uv
uv tool uninstall flowpad

# Using pipx
pipx uninstall flowpad

# Using pip
pip uninstall flowpad

Requirements

Install method	Requirements
Desktop app	None (self-contained)
Python package	Python 3.10+

Both methods require an internet connection on first launch to download dependencies.

Contributing

Flowpad is open source. To set up a local development environment, run the tests, or build the package, see docs/contributing.md.

License

Metadata

Release files for flowpad 0.2.208

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for flowpad 0.2.208
File	Size	Uploaded
flowpad-0.2.208.tar.gz	38.5 MB	Oct 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for flowpad 0.2.208
File	Interpreter	ABI	Platform	Reset
flowpad-0.2.208-py3-none-any.whl 40.7 MB Oct 11, 2026	Python 3	none	any	Details

Total release size: 79.2 MB

Release files / flowpad-0.2.208.tar.gz

Download URL	flowpad-0.2.208.tar.gz
Size	38.5 MB
Tags	Source
SHA-256 checksum How to use checksums	`d9e68514d579a4fa594dddb0d7cf326c5c586979c5d62119bf2eb0f5478375f0`
BLAKE2b-256 checksum How to use checksums	`67671d55b75f74f6889d4411c7e9e2a158f4aefe006a619c51218020343e9616`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.15`

Release files / flowpad-0.2.208-py3-none-any.whl

Download URL	flowpad-0.2.208-py3-none-any.whl
Size	40.7 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`3bc75ff3dbdb2085e06922da64f996c6812ced9eb650d6241e3694517288f5e6`
BLAKE2b-256 checksum How to use checksums	`9a62de906c34c910ee20a986f888d6f216da8047ea15f9138bfe496e22fc729a`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.15`