Nanobot Study

---

_ __ __ _ _ __ ___ | |__ ___ | |_ | '_ \ / ` | ' \ / _ | '_ \ / _ | | | | | | (| | | | | () | |) | () | |_ || ||_,|| ||_/|./ _/ _| nanobot: 3-day Study Repository

🇨🇳 中文文档 (Chinese)

🐈 nanobot is an ultra-lightweight personal AI assistant designed to be learned, dissected, and mastered.

Unlike bloated frameworks that hide their logic, nanobot delivers core agent functionality in just ~3,500 lines of code. It's the perfect "textbook" implementation of a modern LLM agent.

💡 Basic Idea

An AI Agent is not just a chatbot. It is a system that can:

1. Perceive: Read files, search the web, see the terminal output.
2. Think: Use an LLM (Large Language Model) to reason about what to do next.
3. Act: Execute tools (Shell, File I/O, API calls) to affect the environment.
4. Loop: Observe the result of its action and decide the next step.

nanobot implements this Perceive-Think-Act-Loop in its purest form in agent/loop.py. By studying this repository, you aren't just learning a tool; you are learning the fundamental anatomy of Agentic AI.

[!TIP] Using an AI Coding Assistant? (Cursor, Claude Code, GitHub Copilot)

You can turn your AI assistant into a Personal Nanobot Tutor!

1. Open AI_COPILOT.md.
2. Copy its content or ask your AI to "Read AI_COPILOT.md and act as my tutor".
3. The AI will now guide you through the 3-Day Plan using the Socratic method, helping you understand the code instead of just writing it for you.

---

📅 3-Day Mastery Plan

Follow this guided path to go from "User" to "AI Engineer" in just one weekend (2-3 hours/day).

Day 1: The Soul (Architecture)

Objective: Understand how an LLM becomes an Agent.

1. Read (30 min):
   • agent/loop.py: This is the heart. Read how _process_message handles the LLM -> Tool -> LLM cycle.
   • config/: See how we manage prompts and model settings.
2. Action (1 hour):
   • Run nanobot onboard to initialize.
   • Chat: nanobot agent -m "Calculate 128 * 455".
   • Trace: Open ~/.nanobot/workspace and find the log file. Follow the execution path you just read in loop.py.
3. Challenge (1 hour):
   • Modify agent/prompts.py (or equivalent) to give the bot a "Pirate" personality.
   • Restart and verify: nanobot agent -m "Who are you?".

Day 2: The Hands (Skills & Tools)

Objective: Teach the AI to interact with the real world.

1. Read (30 min):
   • agent/tools/: Look at web.py to see how we define tools.
   • skills/: Understand how to bundle tools into skills.
2. Action (1 hour):
   • Create a simple python script my_tool.py that prints "Hello from tool!".
   • Register it in the agent configuration.
3. Challenge (1.5 hours):
   • Build a "Daily Briefing" Skill:
     • Write a tool that fetches top Hacker News headlines (use an API or scraping).
     • Combine it with the existing weather tool.
     • Ask nanobot: "Give me my daily briefing."