Installation

FlowLayer installs two binaries:

• flowlayer-server
• flowlayer-client-tui

Official binaries are available on Linux, macOS, and Windows.

Prerequisites

• A local environment where you can run host processes.

Linux & macOS

Install script (recommended)

curl -fsSL https://raw.githubusercontent.com/FlowLayer/distribution/main/install.sh | sh

Homebrew

brew tap FlowLayer/distribution https://github.com/FlowLayer/distribution.git
brew install flowlayer

Windows

Scoop (recommended)

scoop bucket add flowlayer https://github.com/FlowLayer/distribution.git
scoop install flowlayer

WinGet

winget source update
winget install FlowLayer.FlowLayer

After installing with WinGet, restart your terminal so the PATH update takes effect.

Chocolatey

FlowLayer is approved on Chocolatey Community and can be installed directly with Chocolatey.

choco install flowlayer

Verify the install

flowlayer-server --version
flowlayer-client-tui --version

Expected output:

flowlayer-server 1.1.1
flowlayer-client-tui 1.1.1

PATH setup

install.sh installs FlowLayer binaries into ~/.local/bin for user-level installs. If flowlayer-server or flowlayer-client-tui is not found after installation, add ~/.local/bin to your PATH. This is only relevant for install.sh or manual user-level installs, not normally for Homebrew, Scoop, WinGet, or Chocolatey.

Bash:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Fish:

fish_add_path ~/.local/bin

Verify:

flowlayer-server --version
flowlayer-client-tui --version

Build from source

If you want to build the official TUI client from source or contribute, start from the public repository: https://github.com/FlowLayer/tui

Next step

Continue with First Stack for a minimal server-first run and explicit TUI connection.