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.225
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.225.tar.gz | 40.9 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flowpad-0.2.225-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 84.1 MB
Release files / flowpad-0.2.225.tar.gz
| Download URL | flowpad-0.2.225.tar.gz |
|---|---|
| Size | 40.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8e47947c3cf831e3d7dd6b3d5af28fa9ce09251a4e8295288ee5d20a9422313a
|
|
BLAKE2b-256 checksum How to use checksums |
58d236355aa946ba3538c9734dc17bb8b7d19d9849f33ad9b895d2745f5c17d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.12
|
Release files / flowpad-0.2.225-py3-none-any.whl
| Download URL | flowpad-0.2.225-py3-none-any.whl |
|---|---|
| Size | 43.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
700a5d7c142e1653289f465ceeec2ebe424aa643f9f66da4084462c116b957a9
|
|
BLAKE2b-256 checksum How to use checksums |
fb6120d78e76b2d5761fa05ae00bdb85db82e7c27033e8bd7301b89131c6804a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.12
|
Security for flowpad 0.2.225
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.
