Install

The Factflow CLI (factflow) is the primary management interface to the backend. Install it via the radicalAI Homebrew tap.

Prerequisites

  gh auth login --hostname dnb.ghe.com

brew tap radicalAI/tap dnb@dnb.ghe.com:radicalAI/homebrew-tap.git
brew install factflow

Verify:

factflow version

Expected output:

factflow 0.7.0 (commit: 022d6197, built: 2026-04-22)

brew upgrade factflow

The formula resolves the latest release dynamically — no tap refresh required.

Zsh:

factflow completion zsh > "$(brew --prefix)/share/zsh/site-functions/_factflow"
compinit

Bash:

factflow completion bash > $(brew --prefix)/etc/bash_completion.d/factflow

The CLI talks to a Factflow backend over HTTP. Default target: http://localhost:8000.

Local dev. Run a local backend yourself — see Run your first pipeline.

Shared backend. Use --server:

factflow --server https://factflow.example.dnb.no system health

Or create a named profile:

factflow --server https://factflow.example.dnb.no --profile prod system health
# profile is persisted at ~/.factflow/profiles.json

Subsequent commands use the profile:

factflow --profile prod execution list

Run your first pipeline — spin up a local backend and execute a webscraper config
CLI reference — every command and flag
API reference — the HTTP surface the CLI talks to