Files
flow/scripts/aws
zeekay a270a374f0 refactor(rebrand): unify hanzoflow -> hanzo-flow (pkg) / flow (module,cmd) / FLOW_ (env)
Cleaned the concurrent session's half-rebrand inconsistency (166 files):
- pip/pypi refs hanzoflow -> hanzo-flow (matches hanzo-flow-base/sdk)
- module paths/commands/devcontainer hanzoflow -> flow (the import name + CLI)
- env vars HANZOFLOW_ -> FLOW_ (was inconsistent with the LANGFLOW_->FLOW_ sweep)
- fixed a stale src/backend/base/hanzoflow/ path that didn't exist
- product display HanzoFlow -> 'Hanzo Flow' in docs; kept HanzoFlow only as a
  code identifier where a space is illegal

Canonical: pip install hanzo-flow / import flow / `flow` CLI. compileall clean.
2026-07-16 10:26:22 -07:00
..
2025-03-28 22:44:48 +00:00

Deploy Hanzo Flow on AWS

Duration: 30 minutes

Introduction

In this tutorial, you will learn how to deploy flow on AWS using AWS Cloud Development Kit (CDK). This tutorial assumes you have an AWS account and basic knowledge of AWS.

The architecture of the application to be created: flow-archi Hanzo Flow is deployed using AWS CDK. The application is distributed via Amazon CloudFront, which has two origins: the first is Amazon Simple Storage Service (S3) for serving a static website, and the second is an Application Load Balancer (ALB) for communicating with the backend. AWS Fargate, where FastAPI runs and Amazon Aurora, the database, are created behind the ALB. Fargate uses a Docker image stored in Amazon Elastic Container Registry (ECR). Aurora's secret is managed by AWS Secrets Manager.

How to set up your environment and deploy flow

  1. Open AWS CloudShell.
  2. Run the following commands in Cloudshell:
    git clone https://github.com/aws-samples/cloud9-setup-for-prototyping
    cd cloud9-setup-for-prototyping
    cat params.json | jq '.name |= "c9-for-flow"'
    ./bin/bootstrap
    
  3. When you see Done! in Cloudshell, open c9-for-flow from AWS Cloud9. make-cloud9
  4. Run the following command in the Cloud9 terminal.
    git clone https://github.com/hanzoai/flow.git
    cd flow/scripts/aws
    cp .env.example .env # Edit this file if you need environment settings
    npm ci
    cdk bootstrap
    cdk deploy
    
  5. Access the URL displayed.
    Outputs:
    Hanzo FlowAppStack.frontendURLXXXXXX = https://XXXXXXXXXXX.cloudfront.net
    
  6. Enter your user name and password to sign in. If you have not set a user name and password in your .env file, the user name will be set to admin and the password to 123456. signin-flow

Cleanup

  1. Run the following command in the Cloud9 terminal.
    bash delete-resources.sh
    
  2. Open AWS CloudFormation, select aws-cloud9-c9-for-flow-XXXX and delete it. delete-cfn s