Build Your First Workflow

Learn by building a simple greeting workflow with parameters and validation.

What You’ll Build

A workflow that accepts a name and returns a personalized greeting.

Prerequisites

• Installation complete
• Text editor (VS Code recommended)

Create the Workflow

1. Open the Code Editor from the header.

   

2. Create a new file called hello_world.py:

   

   from bifrost import workflow, param, ExecutionContext
   import logging
   
   logger = logging.getLogger(__name__)
   
   @workflow(
       name="hello_world",
       description="A simple greeting workflow",
       category="Examples"
   )
   @param("name", type="string", label="Your Name", required=True)
   async def hello_world(context: ExecutionContext, name: str):
       """Generate a personalized greeting."""
       logger.info(f"Generating greeting for {name}")
       greeting = f"Hello, {name}! Welcome to Bifrost."
       return {"greeting": greeting, "name": name}

3. Hit CTRL/CMD + S to save.

4. Navigate to Workflows → Examples → Hello World

   

5. Click Execute, enter your name, and click Run

Expected Result

{
    "greeting": "Hello, Alice! Welcome to Bifrost.",
    "name": "Alice"
}

View Execution Logs

Navigate to Executions to see all runs with logs and results.

Next Steps

• Writing Workflows Guide - Full workflow reference
• Using Decorators - Advanced decorator features
• Create Dynamic Forms - Build UI for your workflows