If you've ever seen "The Illustrated Transformer" — the diagram-heavy explainer that made attention mechanisms click for a generation of ML practitioners — you already know why Jay Alammar publishing a new guide is worth paying attention to. On September 7, 2026, Alammar announced that An Illustrated Guide to AI Agents — co-authored with Maarten Grootendorst and published by O'Reilly Media — is out on Kindle and other ebook stores, built around 300+ original figures and roughly 475 pages in print (paperback ships October 13, 2026).
The subtitle on retailer listings — Concepts and Code for Building Agents with LLMs, Tools, and Memory — signals the same dual track Alammar used in "Hands-On Large Language Models": you build a working agent along the way, not just read theory.
TL;DR
| Question | Answer |
|---|---|
| Who published it? | Jay Alammar and Maarten Grootendorst (O'Reilly Media) |
| What's the format? | Illustrated guide with 300+ figures, 475 pages (print), concepts + code |
| When is it available? | Ebook: September 2026; paperback October 13, 2026 |
| What topics does it cover? | Tools, memory, planning, reasoning LLMs, multimodal models, multi-agent systems, evaluation, code agents |
| Why does Alammar's track record matter? | "The Illustrated Transformer" became the default onboarding doc before reading original papers |
| Who is this for? | Learners who want agent internals, not just a LangChain tutorial |
| Where's the hands-on complement on explainx.ai? | Build your first agent loop, step by step |
| How long did they work on it? | Alammar cited ~18 months of production on the LinkedIn announcement |
Why Jay Alammar's name carries weight here
Alammar built his reputation on a specific, hard-to-replicate skill: taking a technically dense system — transformer attention, BERT's masked-token pretraining — and rendering it as a sequence of diagrams that build understanding step by step, without requiring the reader to first parse the original research paper's notation. "The Illustrated Transformer" in particular has been cited and linked from course syllabi, engineering onboarding docs, and countless technical blog posts (including plenty on explainx.ai) as the resource people point newcomers to before they touch the original "Attention Is All You Need" paper. He later co-authored "Hands-On Large Language Models" and worked on ML education efforts with Cohere.
Applying that same method to AI agents is a natural next step, and arguably overdue — agent systems in 2026 have become genuinely complex, spanning reasoning loops, tool calls, memory retrieval, sandboxing, and multi-agent coordination, and most existing educational material explains these pieces through code or framework documentation rather than through the kind of conceptual diagrams that make the underlying mechanics stick.
What the book covers — verified against O'Reilly and retailer listings
Alammar's September 7 LinkedIn post named the scope explicitly: "memory, tools, planning, evaluation, multi-agent systems, and code agents." O'Reilly's catalog entry and retailer descriptions (Indigo, Ingram Academic) expand that into a chapter-level map:
| Topic area | What readers should expect |
|---|---|
| Core architecture | Tools, memory, and planning — the three legs most production agents stand on |
| Reasoning models | How reasoning LLMs change planning and tool-selection behavior |
| Multimodal agents | Vision and other modalities entering the agent loop, not just text-in/text-out |
| Multi-agent collaboration | Coordination patterns when one loop is not enough |
| Training-adjacent methods | Distillation, quantization, reinforcement learning — how model choices constrain agent design |
| Evaluation | Strengths, limitations, and how to judge whether an agent actually works |
| Code agents | Agents that read, edit, and execute code — the category driving most 2026 harness investment |
The production timeline matters too. Alammar wrote that he and Grootendorst spent the last year and a half making "the agent stack legible." That is not a rushed blog-series compilation — it is book-length treatment of concepts that were still moving when they started drafting.
Alammar's framing on launch day: "Agents are being adopted faster than they're being understood. Our bet is that a small number of concepts will outlast everything else in this field." That is the same editorial bet explainx.ai makes in evergreen guides like how AI agents work end-to-end: teach durable primitives (loops, tools, memory, harnesses) rather than chase every framework rename.
Why Maarten Grootendorst as co-author fits
Grootendorst is best known in the ML education space for BERTopic and visual, accessible explainers of NLP and topic modeling — a complementary skill set to Alammar's transformer diagrams. Pairing them on agents mirrors how agent systems themselves combine model behavior (Alammar's wheelhouse since the Illustrated series) with applied ML engineering (Grootendorst's strength in making statistical and embedding concepts tangible).
For readers already using Grootendorst's open-source tooling or following his educational content, the co-authorship is a signal the code examples will be runnable and opinionated, not pseudocode stubs.
What a diagram-first agent guide can do that code can't
Code shows you exactly what happens; it's much worse at showing you why the pieces are arranged the way they are, or how state actually flows between them over time. A well-built diagram of an agent loop — the same category of visual explainx.ai uses in its own how AI agents work end-to-end guide — can show, in one glance, how a user request becomes a plan, how a plan becomes tool calls, how tool results feed back into context, and where a loop terminates or retries. That's the exact value Alammar's transformer diagrams provided for attention: not a replacement for reading the code, but a mental model that makes the code make sense once you do read it.
This distinction matters more for agents specifically than it did for transformers, because agent behavior is shaped as much by the harness wrapped around a model as by the model itself — a point Y Combinator's own harness panel made explicitly this same week, citing the same model weights scoring roughly 30% vs. 95% on ARC-AGI depending entirely on harness quality. Understanding why a harness is built the way it is — not just what API calls it makes — is exactly the kind of conceptual gap a diagram-first guide is positioned to close.
Concepts the Illustrated Transformer series taught — applied to agents
Alammar's transformer explainers succeeded because each figure added one new mechanism before combining them: queries, keys, values, then multi-head attention, then encoder-decoder flow. Agent systems need the same progressive disclosure:
- Single-turn tool call — request → model chooses tool → result appended to context.
- Multi-step loop — plan, act, observe, repeat until stop condition.
- Memory layers — working context vs. retrieved long-term store vs. episodic logs.
- Harness policies — retries, sandbox boundaries, human approval gates.
- Multi-agent delegation — manager/worker splits, handoff protocols.
A 300-figure book has room to animate each transition — something a 2,000-word blog post or a framework README rarely attempts. explainx.ai's multi-agent orchestration patterns guide covers delegation at the pattern level; Alammar's book is positioned to show why those patterns exist at the mechanism level.
Where diagram-first learning still needs a code complement
Figures excel at invariants — what must stay true across frameworks. They struggle with integration friction: API keys, rate limits, MCP server auth, and the skills layer that tells the model which tools exist. That is why Alammar's subtitle promises both concepts and code, and why explainx.ai keeps hands-on companions in parallel:
- Diagrams answer "what is happening?"
- Runnable tutorials answer "why did my agent loop hang on turn four?"
Neither alone covers production concerns like MCP security or tool description reliability — topics a conceptual book may touch at evaluation time but that builders still need operational guides for.
Where this fits next to explainx.ai's own agent resources
A conceptual, illustrated guide and a hands-on, code-first guide serve different but complementary purposes, and pairing them is the fastest path to actually understanding agents rather than just copy-pasting a working example. On explainx.ai:
- How AI agents work, end to end — the conceptual overview closest in spirit to a diagram-first explainer.
- How to build your first agent loop, step by step — the hands-on companion, with runnable code.
- How to build your first agent skill, step by step — extends the same fundamentals into the skills layer.
- What is an agent harness? Complete guide — the scaffolding layer a diagram of "an agent" often glosses over, but which determines most of real-world performance.
- Multi-agent orchestration patterns guide — for once a single agent loop isn't enough.
If you're new to agents, the practical sequence is: read a conceptual guide like Alammar's to build the mental model, then work through a hands-on tutorial to turn that model into working code. Neither one alone gets you all the way there.
Suggested learning path: book + explainx.ai stack
For a reader starting September 2026 with the ebook:
| Step | Resource | Outcome |
|---|---|---|
| 1 | Alammar/Grootendorst — tools, memory, planning chapters | Mental model of the agent loop |
| 2 | How AI agents work, end to end | Map book diagrams to explainx.ai terminology |
| 3 | Build your first agent loop, step by step | Runnable single-agent loop |
| 4 | What is an agent harness? | Understand the 30% vs. 95% harness gap |
| 5 | Build your first agent skill | Add instructional packaging on top of tools |
| 6 | Multi-agent orchestration patterns | When one loop is not enough |
Readers who already ship agents should skim the book for evaluation and multi-agent chapters — the areas where most production teams under-invest until something breaks in prod.
How this compares to other agent education in 2026
The agent education landscape split into three camps this year:
| Camp | Strength | Gap |
|---|---|---|
| Framework docs (LangGraph, CrewAI, etc.) | Copy-paste working examples fast | Framework-coupled mental models |
| Vendor harness guides (Claude Code, Codex) | Production patterns for one client | Less theory on why loops fail |
| Visual explainers (Alammar/Grootendorst) | Durable concepts, progressive figures | May lag bleeding-edge MCP/plugin packaging |
Alammar's book sits in the third camp — the same niche "The Illustrated Transformer" owned for attention. It will not replace loop engineering practice for daily coding, but it gives newcomers the vocabulary to read harness docs without treating every retry policy as magic.
Honest limits
- Price and format: Retail listings show ~$79.99 USD for the paperback; ebook pricing varies by store. Budget accordingly if you are comparing against free explainx.ai tutorials.
- Freshness: Any book with an 18-month production cycle will miss the latest MCP/Agent Plugins packaging wave — pair with Agent Plugins coverage for September 2026 connector standards.
- Print delay: Ebook is available now; paperback readers wait until October 13, 2026 per O'Reilly and retailer listings.
- Not a replacement for evals in production: Evaluation chapters teach judgment; they do not substitute for instrumenting your own agent with traces and regression tests.
Related on explainx.ai
- How AI agents work, end to end
- How to build your first agent loop, step by step
- How to build your first agent skill, step by step
- What is an agent harness? Complete guide
- Multi-agent orchestration patterns guide
- YC's harness panel: self-improving agents, OpenJarvis, and QM
- What are Agent Skills? Complete guide
- Loop engineering for coding agents
- MCP security guide for production agents
- Agent Plugins open standard (August 2026)
Sources
- Jay Alammar, LinkedIn announcement, September 7, 2026 (ebook launch, 300+ figures, co-author Maarten Grootendorst, ~18-month production)
- O'Reilly Media catalog entry for An Illustrated Guide to AI Agents (ISBN 9798341662698, September 2026 ebook, 400+ pages listed)
- Retailer listings (Indigo, Ingram Academic): 475 pages, October 13, 2026 paperback, topic summary
Publication details, figure count, page count, and topic list verified against O'Reilly and retailer listings as of September 11, 2026. Chapter-level ordering may differ in the final print edition.