00 What you'll have at the end
By the end of this guide you'll have:
- A working AI agent running on your machine
- The ability to ask it to read any file and produce a summary
- A starting point for everything else in the full course
01 Mental model: what is an agent?
Strip away the marketing. An "agentic AI" is four pieces wired together:
An LLM — Claude, GPT, Llama, whatever. Reads context, decides what to do next.
Functions the LLM can call: read a file, write a file, run a command, hit an API.
Where it stores what it's learned — usually files, sometimes a database.
The thing that keeps it running. Could be a single prompt, a cron job, or a 24/7 process.
That's it. Everything else — multi-agent orchestration, MCP servers, vault patterns, brain cycles — is built on top of these four pieces.
For this starter, your agent will use:
- Brain: Claude (via Claude Code, the official CLI)
- Tools: Read, Write, Bash — built in to Claude Code
- Memory: a file on your disk
- Loop: a single command you run from the terminal
02 Setup (5 min)
You need three things. If you already have them, skip ahead.
1. A terminal
On Mac: Terminal (built in). On Windows: Windows Terminal with PowerShell or the Git Bash shell. On Linux: you already know.
2. Claude Code (the CLI)
Claude Code is the official Claude command-line tool. It IS the agent — you're not building one from scratch, you're configuring one.
Then verify:
3. An Anthropic API key (or sign in)
Claude Code needs to talk to Claude. Either:
- Easiest: run
claudefor the first time and follow the browser sign-in flow (Claude account) - Pro: get an API key at console.anthropic.com and set
ANTHROPIC_API_KEYin your environment
03 Build your first agent
Now the fun part. Make a folder, drop a sample file in it, then ask Claude Code to summarize it.
Claude Code launches an interactive session. You're now talking to your agent.
Type this prompt and press Enter:
Watch what happens. Claude Code will:
- Use the Read tool to open
sample.txt - Compose a one-sentence summary in its head
- Use the Write tool to create
summary.md - Report back to you with what it did
Each of those tool uses is the agent doing things in the real world. That's the fundamental shift from "chatbot" to "agent": tools.
04 Run it and see it work
Quit Claude Code (Ctrl+C twice or type /exit). Then:
The summary file exists. Your agent created it. You didn't write that file — the agent did.
That's the magic moment. Sit with it.
05 What you just did
You wired a brain (Claude), tools (Read + Write), memory (the filesystem), and a loop (one prompt) into something that did work.
This is the entire pattern. Every Hermes capability — autonomous research, scheduled briefs, multi-agent coordination, custom skills — is built by extending these four pieces. Not by switching frameworks. Not by buying SaaS. By composing.
06 Where to go from here
You have a foundation. Three honest options:
That's the starter. If this got you somewhere, tell a friend.
— Alex