Tutorials¶
Hands-on lessons that build from installation to a full capstone. Each numbered tutorial has a short written guide here (the essence, copy-pasteable) plus the full notebook you can open in Google Colab. Browse them in order, or jump to whichever fits.
| # | Tutorial | What you'll build |
|---|---|---|
| 0 | Installation | Install Neurosurfer and its extras; verify your setup. |
| 1 | Providers & Agents | Connect cloud/local providers; run AgenticLoop, ReactAgent, one-shot Agent. |
| 2 | Custom Tools | Write your own tool and give an agent a new capability. |
| 3 | Graph Agents | Compose multi-step workflows with the graph engine. |
| 4 | MCP Servers | Connect an external MCP server and expose its tools to an agent. |
| 5 | Capstone: Insight Engine | A database-backed insight engine over MCP. |
| 6 | The Architect | An agent that designs, builds, tests and registers a workflow from an intent. |
Those notebooks live under tutorials/ in the repo.
Written guides without a notebook:
| Guide | What it covers |
|---|---|
| SQL Agent | The built-in sql tool — ReactAgent vs AgenticLoop on the same task. |
Prefer reference prose? The guides cover the same concepts in depth.