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
   import logging
   
   logger = logging.getLogger(__name__)
   
   @workflow(category="Examples")
   async def hello_world(name: str):
       """A simple greeting workflow."""
       logger.info(f"Generating greeting for {name}")
       greeting = f"Hello, {name}! Welcome to Bifrost."
       return {"greeting": greeting, "name": name}

   Note how the decorator infers:

   • name: "hello_world" from the function name
   • description: "A simple greeting workflow." from the docstring
   • parameters: name (required string) from the function signature

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