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
Copyright (c) 2024 Langware Labs. All rights reserved.
2 maintainers
Metadata
2 maintainers
Release files for flowpad 0.2.236
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| flowpad-0.2.236.tar.gz | 40.2 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flowpad-0.2.236-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 82.8 MB
Release files / flowpad-0.2.236.tar.gz
| Download URL | flowpad-0.2.236.tar.gz |
|---|---|
| Size | 40.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2cf0c2bc04b1e2491b2530acbec1d7ce8a993aa8d9fbf278e84d2f9ad86b0a97
|
|
BLAKE2b-256 checksum How to use checksums |
84863b51fe7cacce5d6b3872df1e43e2b143f782cd6ebbb9063030305918530f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Release files / flowpad-0.2.236-py3-none-any.whl
| Download URL | flowpad-0.2.236-py3-none-any.whl |
|---|---|
| Size | 42.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64b12c864bb4bd6c9ac0451ca718268003701393336dec57e1dccd560f37a6a7
|
|
BLAKE2b-256 checksum How to use checksums |
127bd060fc0a0dd430262e220f753ce1b1d7fc0083fb51175cc96ac6ce9b5294
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Security for flowpad 0.2.236
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
