Tutorials¶
Hands-on notebooks that build up from installation to a full capstone project. Open any of them directly in Google Colab, or find them under tutorials/ in the repo.
| # | Tutorial | Open in Colab | What you'll build |
|---|---|---|---|
| 0 | Installation |  | Install Neurosurfer and its optional extras; verify your setup. |
| 1 | Providers & Agents | | Connect cloud and local providers, then run AgenticLoop, ReactAgent, and one-shot Agent. |
| 2 | Custom Tools | | Write your own tools and give agents new capabilities. |
| 3 | Graph Agents | | Compose multi-step workflows with the graph engine and Workflow packages. |
| 4 | MCP Servers | | Connect external Model Context Protocol servers and expose their tools to agents. |
| 5 | Capstone: Insight Engine | | Put it all together — a database-backed insight engine over MCP. |
Prefer prose? The guides cover the same concepts with focused, copy-pasteable snippets.