Files
skills/public/hanzo-flow.md
zeekayandHanzo Dev e4b984146d Flow's one host is flow.hanzo.ai
app.flow.hanzo.ai is not a name the edge serves: *.hanzo.ai covers one
label. flow.hanzo.ai serves the app; the marketing page is hanzo.ai/flow.
public/ carries the same two lines, matching what the build renders.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-23 22:11:29 -07:00

2.1 KiB

Hanzo Flow

Visual workflow builder for AI applications. Fork of Langflow.

URLs

  • App: flow.hanzo.ai (the one host; marketing lives at hanzo.ai/flow)
  • 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
  • flow.hanzo.ai routes 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)