Skip to content

⚙️ Installation

Typeflow is distributed as a single Python package that includes both the CLI and the visual editor UI.


🪄 Prerequisites

  • Python 3.12+
  • Git (optional)

🚀 Install

pip install typeflowapp

This installs:

  • The Typeflow CLI

  • The FastAPI backend

  • The Next.js editor build (served statically)

  • All internal dependencies

🧱 Project Setup

To scaffold a new project:

typeflow setup my_app

This:

  • Creates a project folder named my_app

  • Initializes a UV project and virtual environment

  • Installs typeflow inside that venv

  • Sets up the standard folder structure:

my_app/
├── .typeflow/
├── src/
   ├── nodes/
   ├── classes/
   └── __init__.py
├── workflow/
   ├── workflow.yaml
   └── dag.json
├── pyproject.toml
├── .gitignore
└── README.md

🔁 Existing Projects

If you cloned a Typeflow project from GitHub:

python -m venv .venv
source .venv/bin/activate
pip install typeflowapp
typeflow install

This will:

  • Install dependencies

  • Ensure your environment is isolated

  • Guide you to validate, compile, and run workflows