Pi Agent: Set Up Your First Local AI Agent (Full Guide)
This video walks through setting up Pi, Mario Zechner's open-source terminal coding agent, from install to model selection to extending it with prompt templates, skills, extensions, packages, and CLI tools, then shows how to run it either on OpenRouter or fully local via Ollama. It frames Pi as a minimal 'thin harness' (four tools: read, write, edit, bash; ~1,000-token system prompt) versus Claude Code's heavy ~10,000-token spaceship.
Kacper Rutkiewicz | AI Made Simple31 minTranscript found
Quick learning frame
Read this before watching.
Creative automation uses agents to accelerate production while keeping human taste in story, pacing, selection, and critique.
New playlist item from Kacper Rutkiewicz | AI Made Simple; queued for transcript-backed review, topic mapping, and a practical learning artifact.
Skill you build: The ability to install, configure, and safely extend a minimal terminal coding harness (Pi) — pointing it at cloud or local models and adding capability through CLI tools rather than heavy MCPs — instead of depending on a single hand-holding tool.
Watch for the shift from claim to mechanism. The learning value is the point where the transcript reveals a repeatable action, tool boundary, context move, review habit, or artifact.
Concept diagram
Where this video fits.
01Brief
02Source
03Generation
04Selection
05Edit
06Taste Review
Deep lesson
Turn this video into working knowledge.
8,097 cleaned transcript words reviewed across 2,190 timed caption segments.
Thesis
Pi Agent: Set Up Your First Local AI Agent (Full Guide) teaches a practical creative automation move: This video walks through setting up Pi, Mario Zechner's open-source terminal coding agent, from install to model selection to extending it with prompt templates, skills, extensions, packages, and CLI tools, then shows how to run it either on OpenRouter or fully local via Ollama. It frames Pi as a minimal 'thin harness' (four tools: read, write, edit, bash; ~1,000-token system prompt) versus Claude Code's heavy ~10,000-token spaceship.
The goal is not to remember the video. The goal is to extract the operating principle, tie it to timestamped evidence, test how far the claim transfers, and make something reusable.
0:00
Own your intelligence
“There's a real movement right now towards open-source AI models >> >> and owning your own intelligence. But the problem is is that getting started and understanding how to do it gets really overwhelming. This is pie. It's...”
Pi is an open-source terminal coding agent you can point at any model, including local ones, so nothing gets logged or shipped to a server you don't control; the pitch is auditable open code, privacy by default, and building fluency in local hosting before you're priced out or shut down (as happened with Claude Fable). Write down three workflows where you currently depend on a closed cloud model and note which could run locally or on OpenRouter without your data leaving your machine.
9:33
Four things to know
“{slash} clear in Cloud Code. And number four, this is probably the most complex topic about Pi agent, is that every single session is what's called a tree. So, they're not a straight line like you're used to...”
Pi ships in YOLO mode with zero permission prompts and a dangerous bash tool, so install the 'got jeans' Pi permission package for Claude-Code-style prompts; also learn /reload after any MD/agents change, watch the context progress bar (bigger context = dumber and pricier), and understand that sessions are trees you can fork via double-escape or /tree, not straight lines. Install the Pi permission package from pi.dev packages, then practice /reload after editing an MD file and fork a session with double-escape to see the session tree.
21:35
CLI tools over MCPs
“building yourself and it's evolving with your workflows and whatever you're doing at the time. And that's essentially how you upgrade your Pi agent anytime you need to add a new workflow, anytime you're trying to add a...”
Mario's design favors CLI tools over MCPs because MCPs are heavy — a dozen loaded MCPs plus a big system prompt can burn 50-60k tokens every session before you type anything; instead you install something like the Firecrawl CLI (npm install firecrawl-cli), authenticate with an API key, and Pi calls it straight through bash with no middle layer, as demonstrated scraping the Uppa AI site. Install one CLI tool (e.g. Firecrawl CLI), authenticate it, then run a /firecrawl scrape from inside Pi and read the saved markdown to confirm bash-only tooling works.
01
Brief
Start with this video's job: This video walks through setting up Pi, Mario Zechner's open-source terminal coding agent, from install to model selection to extending it with prompt templates, skills, extensions, packages, and CLI tools, then shows how to run it either on OpenRouter or fully local via Ollama. It frames Pi as a minimal 'thin harness' (four tools: read, write, edit, bash; ~1,000-token system prompt) versus Claude Code's heavy ~10,000-token spaceship. Treat "Brief" as the outcome you are trying to make visible, not a topic label. Anchor it to 0:00, where the video says: “There's a real movement right now towards open-source AI models >> >> and owning your own intelligence. But the problem is is that getting started and understanding how to do it gets really overwhelming. This is pie. It's...”
02
Source
Use "Source" to locate the part of the creative automation workflow the video is demonstrating. Ask what changes in your real setup if this claim is true. Anchor it to 9:33, where the video says: “{slash} clear in Cloud Code. And number four, this is probably the most complex topic about Pi agent, is that every single session is what's called a tree. So, they're not a straight line like you're used to...”
03
Generation
Turn "Generation" into the reusable artifact for this lesson: A creative workflow board with critique criteria and review checkpoints. This is where watching becomes something you can inspect and reuse.
04
Selection
Use "Selection" as the application surface. Decide whether the idea touches a browser flow, a local file, a model choice, a source document, a UI, or a review step.
05
Edit
Use "Edit" to prove the lesson. The evidence should connect back to the video title, transcript anchors, and a concrete output, not a generic best-practice claim.
06
Taste Review
Use "Taste Review" to carry the idea forward: save the prompt, checklist, diagram, or operating rule that would make the next agent run better.
Example
Source-backed work packet
Convert the video into a scoped task that includes the transcript claim, target workflow, acceptance criteria, and proof. The output should be a creative workflow board with critique criteria and review checkpoints..
Example
Claim vs. demo brief
Separate what the speaker claims, what the demo actually proves, and what still needs outside verification before you adopt the workflow.
Example
Teach-back module
Transform the lesson into a definition, a mechanism diagram, one misconception, one practice exercise, and a check-for-understanding question.
Do not learn it wrong
Treating the title as the lesson without checking what the transcript actually says.
Letting the prompt drift into generic advice that could apply to any video in the playlist.
Copying the tool setup without identifying the operating principle that transfers to your own stack.
Skipping the artifact, which means the learning never becomes operational or inspectable.
Do not count this as learned until these are true.
01
State the transcript-backed claim in your own words: This video walks through setting up Pi, Mario Zechner's open-source terminal coding agent, from install to model selection to extending it with prompt templates, skills, extensions, packages, and CLI tools, then shows how to run it either on OpenRouter or fully local via Ollama. It frames Pi as a minimal 'thin harness' (four tools: read, write, edit, bash; ~1,000-token system prompt) versus Claude Code's heavy ~10,000-token spaceship.
02
Explain the practical stakes without hype: New playlist item from Kacper Rutkiewicz | AI Made Simple; queued for transcript-backed review, topic mapping, and a practical learning artifact.
03
Map the idea onto the Brief -> Source -> Generation -> Selection -> Edit -> Taste Review sequence and name the weakest link.
04
Produce the artifact and include the evidence that proves it: A creative workflow board with critique criteria and review checkpoints.
Put it into practice
Give this grounded prompt to Codex or Claude after watching.
You are helping me turn one specific YouTube video into real, durable learning.
Source video:
- Title: Pi Agent: Set Up Your First Local AI Agent (Full Guide)
- URL: https://www.youtube.com/watch?v=B5_lAbGeBDY
- Topic: Creative Automation
- My current learning frame: Install Pi from pi.dev, add the permission package, connect a model via OpenRouter, then extend it with one CLI tool and run a real scrape-and-summarize task to feel how the thin harness works.
- Why this matters: New playlist item from Kacper Rutkiewicz | AI Made Simple; queued for transcript-backed review, topic mapping, and a practical learning artifact.
Transcript anchors from this exact video:
- 0:00 / Evidence 1: "There's a real movement right now towards open-source AI models >> >> and owning your own intelligence. But the problem is is that getting started and understanding how to do it gets really overwhelming. This is pie. It's..."
- 2:06 / Evidence 2: "have as we make our way through this video. Most AI coding tools that we're using, especially Claude Code, are massive. They come loaded with features, menus, modes, models, tools, all sorts of stuff. Pi Agent actually takes..."
- 4:07 / Evidence 3: "it's as easy as typing in Pi and pressing enter. I went ahead and closed the other terminals so you guys can see the full thing. We have our Pi agent launched. We can see the context with..."
- 6:52 / Evidence 4: "all these models and brains. Pie agent is incredibly powerful, but it's the opposite of hand-holding. Something like Claude code has so many guardrails that anyone really new can get in there and not mess anything up. There..."
- 9:33 / Evidence 5: "{slash} clear in Cloud Code. And number four, this is probably the most complex topic about Pi agent, is that every single session is what's called a tree. So, they're not a straight line like you're used to..."
- 19:15 / Evidence 6: "on the wrong ladder was another step on top of that, which is CLI tools. CLI tools are actually how Pi Agent prefers to do its work. Because remember, it only really has four tools that you can..."
- 21:35 / Evidence 7: "building yourself and it's evolving with your workflows and whatever you're doing at the time. And that's essentially how you upgrade your Pi agent anytime you need to add a new workflow, anytime you're trying to add a..."
Your task:
1. Use the transcript anchors above as the primary source packet. If you add outside context, label it clearly as outside context and keep it secondary.
2. Create a source-check table with columns: timestamp, claim, what the demo proves, confidence, and what still needs verification.
3. Extract the actual teachable claims from the video. Do not invent claims that are not supported by the title, lesson frame, or transcript anchors.
4. Build a reusable learning artifact: A creative workflow board with critique criteria and review checkpoints.
5. Include:
- a plain-English definition of the core idea
- a diagram or structured model using this sequence: Brief -> Source -> Generation -> Selection -> Edit -> Taste Review
- 3 concrete examples that apply the video idea to real agentic work
- 2 failure modes the video helps prevent
- a checklist I can use the next time I run Codex or Claude
- one practical exercise with a clear done signal
6. Add a "learning transfer" section: what changes in my workflow tomorrow if I actually learned this?
7. Add a "source check" section that cites which transcript anchor supports each major takeaway.
Quality bar:
- Make this specific to "Pi Agent: Set Up Your First Local AI Agent (Full Guide)", not a generic Creative Automation essay.
- Prefer operational examples, failure modes, and reusable artifacts over broad definitions.
- Call out uncertainty instead of smoothing over weak evidence.
- If evidence is weak, say what transcript segment or timestamp needs review instead of guessing.
- Finish with a concise artifact I could paste into my learning app.
Misconceptions
What to stop believing.
Creative AI removes the need for taste.
It increases the need for taste because output volume explodes.
The best prompt is enough.
References, critique, iteration, and post-production matter just as much.
Practice studio
Learning only counts when you make something.
01
Transcript evidence map
Separate what the video actually says from what you already believe about the topic.
3 source-backed takeaways with timestamps, confidence, and a transfer note.02
One useful artifact
Apply the video to a real workflow and produce a creative workflow board with critique criteria and review checkpoints..
A reusable artifact with a done signal and one verification step.03
Teach-back card
Explain the lesson to someone who has not watched the video yet.
A 90-second explanation, one diagram, one example, and one misconception to avoid.
Recall check
Answer first, then reveal — without rewatching.
What four built-in tools does Pi ship with, and why is that considered enough?
What risk does Pi's default YOLO mode create, and how do you mitigate it?
Why does Pi's creator prefer CLI tools over MCPs?
Source shelf
Use the video as a doorway, then verify with primary sources.