# nanobot-cn

**Repository Path**: ybli_code/nanobot-cn

## Basic Information

- **Project Name**: nanobot-cn
- **Description**: nanobot: 超级轻量化个人AI助手
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-05
- **Last Updated**: 2026-02-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <img src="nanobot_logo.png" alt="nanobot" width="500">
  <h1>nanobot: Ultra-Lightweight Personal AI Assistant</h1>
  <p>
    <a href="./READMEEN.md">English</a> | <a href="./READMECN.md">简体中文</a>
  </p>
  <p>
    <a href="https://pypi.org/project/nanobot-ai/"><img src="https://img.shields.io/pypi/v/nanobot-ai" alt="PyPI"></a>
    <a href="https://pepy.tech/project/nanobot-ai"><img src="https://static.pepy.tech/badge/nanobot-ai" alt="Downloads"></a>
    <img src="https://img.shields.io/badge/python-≥3.11-blue" alt="Python">
    <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
  </p>
</div>

## 📖 项目简介

**nanobot** 是一款由香港大学黄超老师课题组开发的**超轻量级**个人 AI 助手。它深受 [Clawdbot](https://github.com/openclaw/openclaw) (OpenClaw) 的启发，但旨在解决其代码过于庞大（40万+行）难以学习和部署的痛点。

⚡️ **核心逻辑仅约 4,000 行代码** —— 在保留完整智能体（Agent）功能的同时，代码量比 OpenClaw 缩小了 **99%**。

### 核心哲学：极简即力量

nanobot 的设计哲学非常朴素：
- **纯 Python 实现**：架构清晰，无需迷失在复杂的类继承和接口抽象中。
- **一键部署**：从克隆代码到工具运行，整个过程压缩在 2 分钟以内。
- **研究友好**：核心逻辑直观，像搭积木一样简单，非常适合开发者学习、修改和定制。

## ✨ 核心特性

- **麻雀虽小，五脏俱全**：
  - 🛠️ **操作能力**：支持文件管理、系统命令、代码编写与执行。
  - 🌐 **连接能力**：支持飞书、微信、Telegram 等主流聊天平台。
  - 🔍 **智能特性**：集成网页搜索、上下文记忆、定时提醒（Cron）。
- **极速响应**：极小的资源占用意味着更快的启动和更高效的迭代。
- **灵活扩展**：可以轻松接入 vLLM 等本地模型或 OpenRouter 等主流 LLM 服务商。

## 🏗️ 架构原理

nanobot 剥离了复杂的冗余，回归了 Agent 的核心本质 —— **消息处理循环**：

1. **接收输入**：获取用户消息及上下文。
2. **分析判断**：LLM 分析当前需求是直接回复还是调用工具。
3. **执行动作**：调用工具（搜索、执行代码等）并获取反馈。
4. **输出响应**：完成任务后回复用户，或继续下一轮循环。

## 🚀 快速开始

详细的安装和配置指南请参考：

- 🇺🇸 [English Documentation](./READMEEN.md)
- 🇨🇳 [中文文档](./READMECN.md)

---
*本项目上线 3 天内在 GitHub 获得 5000+ Star，深受开源社区关注。欢迎加入我们，打造你的专属“贾维斯”！*