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) Flowpad-arm64.dmg
macOS (Intel) Flowpad-x64.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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.128)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for eran_langware from gravatar.com eran_langware Avatar for GadiTunes from gravatar.com GadiTunes

Credits

Author: Langware Labs

Requires

Python >=3.10

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flowpad-0.2.126.tar.gz (32.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

flowpad-0.2.126-py3-none-any.whl (34.2 MB view details)

Uploaded Python 3

File details

Details for the file flowpad-0.2.126.tar.gz.

File metadata

  • Download URL: flowpad-0.2.126.tar.gz
  • Upload date:
  • Size: 32.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.17

File hashes

Hashes for flowpad-0.2.126.tar.gz
Algorithm Hash digest
SHA256 d5f79cbded621ed871d9a0f8197d9412fb68e54c78ec945a1dceeeb30ec8d6b7
MD5 c50667e514cab3cddb49c91c8a166f32
BLAKE2b-256 19c24ce785dfe30a0e096190d433fe765596b727e5cd6aa55ca3f6c8fab3272d

See more details on using hashes here.

File details

Details for the file flowpad-0.2.126-py3-none-any.whl.

File metadata

  • Download URL: flowpad-0.2.126-py3-none-any.whl
  • Upload date:
  • Size: 34.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.17

File hashes

Hashes for flowpad-0.2.126-py3-none-any.whl
Algorithm Hash digest
SHA256 055ce51ceb77e2e3a357ebd6e3aa77cbf7bbb82285f70fbf0a4b5ebcab3ab83f
MD5 f6fcf68a91e6cfe8ad9c08a419e6253b
BLAKE2b-256 31cba8835f1baa13b7b7c4dc5f33496a775a3749cda0e3e055a3678a53784b31

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2.128

0.2.127

This release

0.2.126

0.2.125

0.2.124

0.2.123

0.2.122

0.2.121

0.2.120

0.2.119

0.2.118

0.2.117

0.2.116

0.2.115

0.2.114

0.2.113

0.2.112

0.2.111

0.2.110

0.2.109

0.2.108

0.2.107

0.2.106

0.2.105

0.2.104

0.2.103

0.2.102

0.2.101

0.2.100

0.2.99

0.2.98

0.2.97

0.2.96

0.2.95

0.2.94

0.2.93

0.2.92

0.2.91

0.2.90

0.2.89

0.2.88

0.2.87

0.2.86

0.2.85

0.2.84

0.2.83

0.2.82

0.2.81

0.2.80 yanked

Reason this release was yanked:

bad charchaters

0.2.79

0.2.78

0.2.77

0.2.76

0.2.75

0.2.74

0.2.73

0.2.72

0.2.71

0.2.70

0.2.69

0.2.68

0.2.67

0.2.66

0.2.65

0.2.64

0.2.63

0.2.62

0.2.61

0.2.60

0.2.59

0.2.58

0.2.57

0.2.56

0.2.55

0.2.54

0.2.53

0.2.52

0.2.51

0.2.50

0.2.49

0.2.48

0.2.47

0.2.46

0.2.45

0.2.44

0.2.43

0.2.42

0.2.41

0.2.40

0.2.39

0.2.38

0.2.37

0.2.36

0.2.35

0.2.34

0.2.33

0.2.32

0.2.31

0.2.30

0.2.29

0.2.28

0.2.27

0.2.25

0.2.24

0.2.23

0.2.22

0.2.21

0.2.20

0.2.19

0.2.18

0.2.17

0.2.16

0.2.13

0.2.12

0.2.9

0.2.8

0.2.7

0.2.6

0.2.5

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.1.59

0.1.58

0.1.57

0.1.56

0.1.55

0.1.54

0.1.53

0.1.52

0.1.51

0.1.50

0.1.49

0.1.48

0.1.47

0.1.46

0.1.45

0.1.44

0.1.43

0.1.42

0.1.41

0.1.40

0.1.39

0.1.38

0.1.37

0.1.36

0.1.35

0.1.34

0.1.33

0.1.32

0.1.31

0.1.30

0.1.29

0.1.28

0.1.27

0.1.26

0.1.25

0.1.24

0.1.23

0.1.22

0.1.21

0.1.19

0.1.18

0.1.17

0.1.16

0.1.15

0.1.14

0.1.13

0.1.12

0.1.11

0.1.10

0.1.9

0.1.8

0.1.7

0.1.6

0.1.5

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page