hanzo-flow

Visual workflow builder for AI applications.

Hanzo Flow

Visual workflow builder for AI applications. Fork of Langflow.

URLs

Landing: flow.hanzo.ai
App: app.flow.hanzo.ai
IAM Client ID: hanzo-flow
Docker Image: ghcr.io/hanzoai/flow:main

Tech Stack

Runtime: Python 3.12 (bookworm-slim builder, trixie-slim runtime)
Framework: FastAPI + Typer CLI
Package Manager: uv (workspace with pyproject.toml)
Database: PostgreSQL (via FLOW_DATABASE_URL, requires --extra postgresql for psycopg driver)

Workspace Structure

src/backend/base/ — core flow package (langflow-base on PyPI)
src/backend/flow/ — root hanzoflow package
src/lfx/ — LFX extensions
pyproject.toml — root workspace config
uv.lock — locked dependencies

Key Config

FLOW_SSO_ENABLED=true, FLOW_SSO_PROVIDER=oidc, FLOW_OIDC_ISSUER_URL=https://hanzo.id
LANGFLOW_CONFIG_DIR=/app/data (writable dir for settings/SQLite)
LANGFLOW_BACKEND_ONLY=true (API-only mode, no embedded frontend)

Build & Deploy

uv sync --frozen --no-dev --extra postgresql
python -m flow run --host 0.0.0.0 --port 7860 --backend-only

Dockerfile CMD: python -m flow run --host 0.0.0.0 --port 7860 --backend-only
Docker build uses --extra postgresql (psycopg driver required for production PG)
K8s: deployment/flow, service/flow, port 7860
Health check: GET /health on port 7860
Both flow.hanzo.ai and app.flow.hanzo.ai route to the flow service

Package Rename Status (2026-03-27)

Internal package renamed from langflow → flow (979 files)
PyPI package: hanzo-flow (was hanzoflow)
CLI binary: flow (via [project.scripts] flow = "flow.launcher:main")
Dockerfile now uses python -m flow run (working as of 2026-03-27)
Telemetry renamed: _get_langflow_desktop → _get_flow_desktop
Env vars still use LANGFLOW_* prefix (backward compat)
LANGFLOW_SSO_ENABLED, LANGFLOW_OIDC_* used for SSO config

Upstream

Fork of: langflow-ai/langflow
Behind upstream: varies
openai version conflict: hanzo-llm needs >=2.8.0, other deps cap <2.0.0 (overridden)