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 through a local MCP tool, captures user details, validates addresses, runs deterministic logic, fans out child steps from inside a step, and optionally spawns concurrent mini-flows at the document level. 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 how the demo combines tool calls, nested step execution, and concurrent flow fan-out.

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.