← all wireframes

Docs detail · /docs/install

v17 · sidebar + ToC + body + prev/next
v17
DESKTOP · 1440px · article page with ToC
floom.dev/docs/install
Docs / Getting started / Install in 60 seconds

Install in 60 seconds.

The Floom CLI is a single static Go binary. No Node. No Python. No Docker required to run most apps.

Last updated 2026-04-20 by @federico · 3 min read · Edit on GitHub →

Prerequisites #

You need one of the following:

  • curl on macOS or any Linux
  • brew on macOS or Linux (Homebrew)
  • Windows users: use WSL, native binary coming in 0.9.

macOS and Linux #

The one-line installer downloads the right binary for your arch and drops it in /usr/local/bin.

# download + install $ curl -fsSL https://floom.dev/install.sh | sh # or, via Homebrew $ brew install floom # verify install $ floom --version floom 0.8.0 (darwin/arm64, 2026-04-22)

Checksums. Every release is signed and the installer verifies SHA-256 before running. See security policy.

Sign in #

Once installed, authenticate with your Floom account. This stores a scoped API key in ~/.floom/credentials.

$ floom login # opens browser, OAuth flow, returns to CLI ✓ signed in as fede@floom.dev ✓ key saved to ~/.floom/credentials

Run your first app #

From the store, pick an app slug. Then run it with a JSON input.

$ floom run lead-scorer --input '{"company":"stripe.com"}' ✓ run_8f2a3c created # streaming output... { "score": 9.2, "tier": "hot", "reasoning": "enterprise-scale payments..." } ✓ completed in 4.2s

What's next #

  • Bring your own Gemini key to bypass the anon rate limit.
  • Build your own app with floom init.
  • Deploy from a GitHub repo.
v17 notes