MESHFLOW_MOCK=1 python3 hands_on/01_hello_mesh.pyBy the end of this lesson, you should be able to explain:
Estimated time: 35 to 50 minutes.
AI means software that performs tasks that normally require human-like judgment. That does not mean the software is conscious, alive, or truly understands the world the way a person does. It means the software can produce useful behavior from data, rules, statistics, search, optimization, or learned patterns.
Examples of AI:
The important idea is this:
AI is the broad field.
Generative AI is one category inside AI.
LLMs are one major kind of generative AI.
Agents and workflows are systems built around models.
Traditional AI often predicts, classifies, ranks, or detects.
Examples:
Generative AI creates new content.
Examples:
Traditional AI often outputs a label, score, category, or prediction. Generative AI outputs content.
That content can be useful, but it must be treated carefully. A generated answer can sound polished even when it is incomplete or wrong.
An LLM, or large language model, is a model trained to work with text. You give it text input, and it generates text output.
In a simple application, the flow looks like this:
user question -> application -> LLM -> generated answer -> user
The input text is often called the prompt. In real systems, the prompt can contain much more than the user's visible question:
All of that input is called context.
Think of an LLM as a powerful text prediction engine that has learned many patterns from training data.
When you ask:
Explain what an AI agent is.
The model generates a likely useful answer based on patterns it learned and the context it was given.
This is why LLMs can feel intelligent. They can combine ideas, follow instructions, write fluent text, and adapt to many tasks.
This is also why LLMs need supervision. They can generate plausible text without checking whether every statement is true, current, or grounded in your private data.
An LLM call by itself does not automatically have:
Applications add those capabilities around the model.
This is the first major reason orchestration matters. Real AI systems are not only "model in, answer out." They are controlled systems that decide what context to send, what tools to expose, what memory to retrieve, what outputs to check, and what steps to run next.
AI is the broad category. An LLM is one type of AI model.
All LLMs are AI. Not all AI systems are LLMs.
Generative AI creates content. LLMs generate text. Image generators, audio generators, and video generators are also generative AI, but they are not all LLMs.
An LLM is the model. A chatbot is an application interface built around a model. A chatbot may include memory, tools, retrieval, safety filters, and custom instructions.
An LLM responds to input. An agent uses an LLM inside a system that can pursue a goal, choose actions, call tools, observe results, and continue.
An agent can decide what action to take. A workflow defines a controlled process. In serious systems, you often combine them: an agent works inside workflow boundaries.
Imagine asking one LLM prompt:
Research MeshFlow, compare it with other orchestration frameworks, write a
tutorial, check it for quality, and publish it.
That prompt asks for many things at once:
If everything happens inside one prompt, it is hard to know:
MeshFlow-style orchestration breaks the work into explicit pieces:
capture_goal
-> research
-> compare
-> draft
-> quality_check
-> approval_gate
-> publish
Each step can produce an artifact, and the workflow can record a trace.
That is the bridge from "what is an LLM?" to "why do we need orchestration?"
In this first lab, you will run the simplest possible workflow: one simulated LLM node that produces one artifact.
Run this from the repository root:
python3 -m src.mini_meshflow compile examples/01_basic_llm.json
Expected idea:
llm_explanation.Now run it:
python3 -m src.mini_meshflow run examples/01_basic_llm.json
You should see a trace with one completed node.
Open the workflow:
Look at these fields:
id: the node name.type: what kind of node it is.input: the prompt text.produces: the artifact name.Even this tiny workflow has a shape:
prompt node -> artifact
That shape is the beginning of orchestration.
Open examples/01_basic_llm.json.
Change:
"input": "Explain an LLM in one beginner-friendly paragraph."
to:
"input": "Explain generative AI in one beginner-friendly paragraph."
Run:
python3 -m src.mini_meshflow run examples/01_basic_llm.json
Observe what changed.
This exercise is small on purpose. You are learning that a workflow node has an input and produces a named output. Later, the input will include memory, tool results, retrieved documents, and previous artifacts.
Answer these before moving to Lesson 02:
AI is the broad field of software that performs intelligent-seeming tasks. Generative AI creates new content. LLMs are generative AI models that work with text. An LLM is powerful, but it is not automatically an agent, memory system, tool user, verifier, or workflow engine.
MeshFlow-style orchestration exists because useful AI systems need structure around the model: steps, dependencies, artifacts, gates, and traces.
You are ready for Lesson 02 when you can say:
An LLM generates text from context. A real AI application adds memory, tools,
checks, and workflow control around the model.
Next lesson:
Run:
python3 -m src.mini_meshflow compile examples/01_basic_llm.json
Write down:
Run:
python3 -m src.mini_meshflow run examples/01_basic_llm.json
Find:
Open ../../examples/01_basic_llm.json.
Change the input value to:
"Explain generative AI in one beginner-friendly paragraph."
Run the workflow again and compare the output.
Write two sentences: