Tutorial: Basic Flow

This tutorial shows how to build Picoflow’s BasicFlow end-to-end: a step‑oriented, tool‑calling agent that collects weather comparisons, user details, validates addresses, runs deterministic logic, spawns concurrent mini-flows, and loops with structured outputs. You will:

Stand up the Picoflow service on NestJS/Node.js with MongoDB/Cosmos DB.
Wire the flow shell and understand how the engine persists session state.
Implement each step pattern demonstrated in src/myflow/basic-flow.
Observe the session document and replay a conversation locally.

Note

We mirror the structure and pacing of the original hotel tutorial, but every lesson maps directly to the basic-flow source code you have in this repo.

Ready? Start with Lesson 1 to get your environment running.