Skip to main content

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

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+.

# 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.

Metadata

Release files for flowpad 0.2.228

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.228
File Size Uploaded Provenance
flowpad-0.2.228.tar.gz 40.0 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for flowpad 0.2.228
File Interpreter ABI Platform
flowpad-0.2.228-py3-none-any.whl Python 3 none any Details

Total release size: 82.2 MB

Release files / flowpad-0.2.228.tar.gz

Download URL flowpad-0.2.228.tar.gz
Size 40.0 MB
Tags Source
SHA-256 checksum
How to use checksums
d71445ea488ddd32ae26a1e4da18b93db26f5c9af0c3dbaf43b32687c1fbe1a6
BLAKE2b-256 checksum
How to use checksums
f1377fe33a6f15dcee8cb1573996e2d20870fa0fdc12d8367098ceadbfc0cecc
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.228-py3-none-any.whl

Download URL flowpad-0.2.228-py3-none-any.whl
Size 42.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
31873d808ce930316cf6f04a690c5ba0325c83d4c103ad345557dcfea1cc83f4
BLAKE2b-256 checksum
How to use checksums
3651e293d4bbde4c5af30b42a8366dbd3bb14d32d729a6e9dcf8699d6117758a
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.228

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.

Release history Release notifications | RSS feed

This release

0.2.228 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page