admin/Obsidian
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
63bd35f7096471e4f7261b5a09e222e5c4634336
Obsidian/githubLibs/nanobot-webui.md
T
coco 1b8027e61c 时地方
2026-07-21 14:53:24 +08:00

307 lines
11 KiB
Markdown
Raw Blame History

---
title: "codemo1991/nanobot-webui: 🎯 Nanobot WebUI — A Smarter, More Efficient Claude AI Assistant ✅ Coding & Bug Fixes ✅ Excel / PDF / PPT Processing ✅ Git Automation ✅ Visual Configuration Panel ✅ Q&A & Knowledge Management 24/7 ready to boost your productivity 🚀"
source: "https://github.com/codemo1991/nanobot-webui"
author:
- "[[GitHub]]"
published:
created: 2026-03-16
description: "🎯 Nanobot WebUI — A Smarter, More Efficient Claude AI Assistant ✅ Coding & Bug Fixes ✅ Excel / PDF / PPT Processing ✅ Git Automation ✅ Visual Configuration Panel ✅ Q&A & Knowledge Management 24/7 ready to boost your productivity 🚀 - codemo1991/nanobot-webui: 🎯 Nanobot WebUI — A Smarter, More Efficient Claude AI Assistant ✅ Coding & Bug Fixes ✅ Excel / PDF / PPT Processing ✅ Git Automation ✅ Visual Configuration Panel ✅ Q&A & Knowledge Management 24/7 ready to boost your productivity 🚀"
tags:
- "clippings"
---
**Tribute to nanobot**
*This project is built upon [nanobot](https://github.com/HKUDS/nanobot) for secondary development. nanobot was inspired by [Clawdbot](https://github.com/openclaw/openclaw), implementing complete Agent functionality with approximately 4000 lines of core code. Thanks to the nanobot community for the lightweight, readable, and extensible foundation.*
---
## 📢 What's New in This Fork
This fork extends nanobot with **Web UI**, **MCP support**, **additional channels** (Discord, QQ, DingTalk), **document/office skills**, **system monitoring**, and more.
---
## ✨ Features Overview
| Category | Features |
| --- | --- |
| **Core Capabilities** | Multi-platform: Web UI, Telegram, Feishu, CLI; Local运行，保护隐私; Support for multiple LLMs (DeepSeek, Claude, GPT, etc.) |
| **Function Modules** | File system operations, Code execution, Memory system (long-term + daily notes), Extensible skill system |
| **Web UI** | React + TypeScript SPA: Chat, Config (Channels/Providers/Models/MCP/Skills), System Status |
| **Channels** | Discord, QQ (qq-botpy), DingTalk (钉钉), plus original Telegram, WhatsApp, Feishu |
| **MCP** | Model Context Protocol integration — connect external tools via stdio/HTTP/SSE |
| **Skills** | `claude-code`, `git-manager`, `xlsx`, `pdf`, `pptx`, `skill-creator`, `mirror-system`, `code-review-expert` |
| **Cron** | Schedule reminders and recurring tasks — set fixed-time or interval-based jobs |
| **Providers** | Zhipu (智谱), DashScope (通义千问), vLLM, OpenRouter, Anthropic, OpenAI, DeepSeek, Groq, Gemini, Minimax |
| **Startup Scripts** | `nanobot-launcher.sh` (Linux/macOS) + `nanobot-launcher.ps1` (Windows) — Auto environment check, dependency update, frontend build, one-click launch |
| **System** | StatusRepository (SQLite), SystemStatusService (uptime, session count), centralized logging |
---
## 🛠️ Built-in Skills
nanobot-webui comes with a powerful skill system that extends the AI's capabilities:
| Skill | Description |
| --- | --- |
| **claude-code** | Delegate coding tasks to Claude Code CLI for advanced code generation and refactoring |
| **git-manager** | Git repository management — commit, push, pull, branch operations |
| **xlsx** | Excel spreadsheet operations — read, write, edit.xlsx files |
| **pdf** | PDF operations — read, write, merge, split PDF documents |
| **pptx** | PowerPoint presentation operations — create and edit.pptx files |
| **skill-creator** | Create new skills to extend nanobot's capabilities |
| **mirror-system** | Self-awareness exploration system for personal growth |
| **code-review-expert** | Git diff code review — analyze changes and provide feedback |
### Creating Custom Skills
The skill system is extensible. You can create custom skills by implementing skill functions that the AI can invoke. See the `skill-creator` skill for a template.
---
## ⏰ Scheduled Tasks (Cron)
nanobot-webui supports scheduled tasks through a built-in Cron system, allowing you to set up recurring reminders and automated actions:
| Feature | Description |
| --- | --- |
| **Fixed-Time Jobs** | Schedule tasks at specific times (e.g., daily 9:00 AM, weekly Monday 10:00 AM) |
| **Interval Jobs** | Run tasks at regular intervals (e.g., every 30 minutes, every 2 hours) |
| **Recurring Reminders** | Set up periodic reminders for meetings, deadlines, health checks, etc. |
| **Message Channels** | Send scheduled messages to any configured channel (Feishu, Telegram, Discord, etc.) |
### Usage Example
```
# Set a daily reminder
"每天早上 9 点提醒我喝水"
# Set a weekly meeting reminder
"每周一上午 10 点提醒我开周会"
# Set an interval check
"每半小时检查一下服务器状态"
```
The Cron system runs in the background and automatically delivers scheduled messages to your configured channels.
---
## 📸 Screenshots
### Chat
Multi-turn conversation with Nanobot, Markdown rendering, new sessions and history. Example shows weather query — Agent fetches real-time data via MCP tools and returns structured card results.
[![Chat interface](https://github.com/codemo1991/nanobot-webui/raw/main/case/chat.png)](https://github.com/codemo1991/nanobot-webui/blob/main/case/chat.png)
### System Status
View service health, uptime, active session count, installed Skills, workspace path, and system environment info.
[![System status](https://github.com/codemo1991/nanobot-webui/raw/main/case/system_status.png)](https://github.com/codemo1991/nanobot-webui/blob/main/case/system_status.png)
### Config — Channels (IM)
Manage IM channel enablement and config — Feishu, Discord, QQ, DingTalk, Telegram, WhatsApp, and more.
[![Channels config](https://github.com/codemo1991/nanobot-webui/raw/main/case/setting_channels.png)](https://github.com/codemo1991/nanobot-webui/blob/main/case/setting_channels.png)
### Config — Providers (AI)
Manage AI model providers — DeepSeek, Qwen, Zhipu, OpenAI, Anthropic, OpenRouter, vLLM, Groq, Gemini, etc. Add, edit, or remove providers.
[![Providers config](https://github.com/codemo1991/nanobot-webui/raw/main/case/setting_providers.png)](https://github.com/codemo1991/nanobot-webui/blob/main/case/setting_providers.png)
### Config — Default Model
Set the default Agent model — model name (provider/model-name format), Temperature, Max Tokens, and other parameters.
[![Default model config](https://github.com/codemo1991/nanobot-webui/raw/main/case/default_model.png)](https://github.com/codemo1991/nanobot-webui/blob/main/case/default_model.png)
### Config — MCP
Manage Model Context Protocol servers — stdio, http, sse, streamable\_http. Import/generate JSON or add new MCP services.
[![MCP config](https://github.com/codemo1991/nanobot-webui/raw/main/case/mcp.png)](https://github.com/codemo1991/nanobot-webui/blob/main/case/mcp.png)
### Config — Skills
Manage AI skills — select skill folders for upload to workspace, view installed skills (version, status, description), enable or disable.
[![Skills management](https://github.com/codemo1991/nanobot-webui/raw/main/case/skills.png)](https://github.com/codemo1991/nanobot-webui/blob/main/case/skills.png)
---
## 🚀 Quick Start
### Install
```
git clone https://github.com/codemo1991/nanobot-webui.git
cd nanobot-webui
pip install -e .
```
The intelligent startup scripts in the `scripts/` directory handle everything automatically — the simplest way to get started:
**Supported Platforms:**
- **Linux / macOS:** `nanobot-launcher.sh`
- **Windows PowerShell:** `nanobot-launcher.ps1`
**What it does:**
- ✅ Automatically checks Python (≥3.11) and Node.js environment
- ✅ Automatically installs/updates Python dependencies
- ✅ Automatically builds the frontend
- ✅ One-click launches the Web UI service
**Usage:**
- **Windows (PowerShell):**
```
.\scripts\nanobot-launcher.ps1
```
- **Linux / macOS:**
```
chmod +x scripts/nanobot-launcher.sh
./scripts/nanobot-launcher.sh
```
Then open [http://127.0.0.1:6788](http://127.0.0.1:6788/)
> **Tip:** Run the script again anytime to update dependencies and restart the service — the simplest way to keep your installation up-to-date!
### Manual Startup (Without Scripts)
### Web UI
```
# Build frontend (first time)
cd web-ui && npm install && npm run build && cd ..
# Start Web UI (backend + static files)
nanobot web-ui
```
Open [http://127.0.0.1:6788](http://127.0.0.1:6788/) — Chat, Config, and System pages are available.
### CLI Chat
```
nanobot onboard # Initialize config
# Edit ~/.nanobot/config.json with your API key
nanobot agent -m "Hello!"
```
### Docker
```
# Build the image
docker build -t nanobot-webui .
# Run (recommended: mount volume for config persistence)
docker run -d -p 6788:6788 -v nanobot-data:/root/.nanobot --name nanobot nanobot-webui
# Or use host path for config
docker run -d -p 6788:6788 -v ~/.nanobot:/root/.nanobot --name nanobot nanobot-webui
```
Then open [http://127.0.0.1:6788](http://127.0.0.1:6788/). On first launch, the app auto-creates `~/.nanobot/config.json`; add your API key via the Config page in the Web UI.
---
## 💻 Web Interface Features
- **Chat** — Create sessions, multi-turn conversations, Markdown rendering, session persistence
- **File Browser** — Browse and manage workspace files directly from the UI
- **Session History** — View and manage conversation history
- **Model Switching** — Easily switch between different AI models
- **Config** — Manage Channels (IM), Providers, Models, MCP servers, Skills
- **System** — Health check, uptime, session count, system info, config export
---
## 📦 Optional Dependencies
```
# Feishu
pip install nanobot-ai[feishu]
# QQ
pip install nanobot-ai[qq]
# DingTalk
pip install nanobot-ai[dingtalk]
# MCP
pip install nanobot-ai[mcp]
```
---
## 📁 Project Structure (This Fork)
```
nanobot/
├── agent/ # Core agent (loop, context, memory, tools)
│ └── tools/ # mcp.py, filesystem, shell, registry...
├── channels/ # telegram, whatsapp, feishu, discord, qq, dingtalk
├── web/ # REST API server (api.py)
├── mcp/ # MCP loader
├── storage/ # StatusRepository (SQLite)
├── services/ # SystemStatusService
├── skills/ # claude-code, git-manager, xlsx, pdf, pptx, skill-creator, mirror-system, code-review-expert...
├── providers/ # LLM providers (OpenAI, Anthropic, DeepSeek, etc.)
├── config/ # Extended schema (Discord, QQ, DingTalk, MCP)
└── cli/ # web-ui command, status, etc.
web-ui/ # React SPA (Chat, Config, System)
scripts/ # Startup scripts (nanobot-launcher.sh, nanobot-launcher.ps1)
```
---
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request or open an Issue for bugs and feature requests.
### Development Setup
```
# Clone the repository
git clone https://github.com/codemo1991/nanobot-webui.git
cd nanobot-webui
# Install in development mode
pip install -e .
# Install web-ui dependencies
cd web-ui && npm install
# Run development server
cd ..
nanobot web-ui
```
### Code Style
- Python: Follow PEP 8
- JavaScript/TypeScript: Follow ESLint configuration
- Commit messages: Use clear, descriptive messages
---
## 📄 License
MIT License — see LICENSE file for details.
---
## 🤝 Credits
- **[nanobot](https://github.com/HKUDS/nanobot)** — The base project this fork builds upon
- **nanobot contributors** — For the lightweight, research-friendly design
---
*Thanks for visiting ✨ nanobot-webui!*
Reference in New Issue View Git Blame Copy Permalink