Generated by Code IQ · v1.0

nanobot
Knowledge Tutorial

A chapter-by-chapter walkthrough of nanobot, generated from its source code and tutorial markdown.

6
Chapters
-
Subsystems
∞
Rabbit Holes
▶ Start Reading ⎇ View on GitHub
System Architecture

How the pieces fit

nanobot is organized as connected concepts and components. Start broad, then drill down chapter by chapter.

⚙️
Channel Gateway
Channel Gateway
👥
The Agent Loop
The Agent Loop
⚙️
LLM Provider Abstraction
LLM Provider Abstraction
⚙️
Memory & Persistence
Memory & Persistence
🔧
Tooling System
Tooling System
⚙️
Task Scheduling
Task Scheduling
nanobot — bash
➜open tutorial
◆ Scanning numbered chapters
◆ Building navigation and Mermaid diagrams
◆ Generating chapter and subsystem pages
✓ 6 chapter pages built
✓ Theme toggle enabled
➜
Repository Overview

Intro and Architecture Diagram

Nanobot is a modular AI assistant designed to bridge external chat platforms (like Telegram and WhatsApp) with powerful Large Language Models. Its core "brain," the Agent Loop, orchestrates conversations by maintaining persistent memory, executing practical tools (such as file editing or web searching), and managing scheduled tasks to allow the bot to act proactively as well as reactively.

Source Repository: https://github.com/HKUDS/nanobot

flowchart TD A0["The Agent Loop"] A1["Tooling System"] A2["Channel Gateway"] A3["LLM Provider Abstraction"] A4["Memory & Persistence"] A5["Task Scheduling"] A0 -->|"Generates responses via"| A3 A0 -->|"Invokes capabilities"| A1 A0 -->|"Maintains conversation state"| A4 A2 -->|"Forwards external events"| A0 A0 -->|"Integrates background services"| A5 A1 -->|"Configures jobs via tools"| A5
Tutorial Chapters

All 6 chapters

Follow sequentially or jump to any topic. Start with Channel Gateway.

Ch.01 CORE
Channel Gateway
Welcome to the nanobot project! You are about to build a sophisticated AI agent, but before our bot can think, plan, or remember, it needs…
↗
Ch.02 AGENTS
The Agent Loop
In the previous chapter, Channel Gateway, we gave our bot ears to hear messages and a mouth to speak them. But right now, if you say "Hello…
↗
Ch.03 CORE
LLM Provider Abstraction
In the previous chapter, The Agent Loop, we built the "Conductor" that orchestrates the bot's thinking process. We saw code like self.provi…
↗
Ch.04 CORE
Memory & Persistence
In the previous chapter, LLM Provider Abstraction, we gave our bot a "universal brain" capable of thinking by connecting to models like GPT…
↗
Ch.05 TOOLS
Tooling System
In the previous chapter, Memory & Persistence, we gave our bot a long-term memory. It now knows who you are and what you talked about yeste…
↗
Ch.06 CORE
Task Scheduling
In the previous chapter, Tooling System, we gave our bot "hands" to perform actions like searching the web or running code.
↗
About This Project

Generated by Code IQ

This tutorial was automatically generated by Code IQ and rendered with the shared tutorial site builder. It can be produced for any repository tutorial folder that follows the numbered markdown chapter layout.

View Code IQ ↗
python build_site.py '/home/runner/work/Code-IQ/Code-IQ/output/nanobot'

// → 6 chapters
// → source: HKUDS/nanobot