📦 HKUDS/nanobot：轻量级开源个人AI代理，一站式工具、聊天与工作流助手

🐈 nanobot 是一个开源的、超轻量的个人 AI 代理，你可以真正拥有它。它保持了代理核心的小巧和可读性，同时为你提供实际长期运行工作所需的组件：WebUI、聊天频道、工具、记忆、MCP、模型路由、自动化和部署。

你想要...	前往
无需终端/配置背景即可安装 nanobot	无需技术背景的入门指南
快速安装并获取一条 CLI 回复	安装与快速开始
打开内置的浏览器界面	WebUI
连接 Telegram、Discord、WeChat、Slack、Email、Mattermost 或其他聊天应用	聊天应用
配置提供程序、后备模型、Langfuse、MCP、Web 工具或安全设置	文档 与 配置
理解或扩展内部机制	架构 与 开发

• 2026-06-22 🚀 发布 v0.2.2 — 耐久性发布 让 nanobot 在日常代理工作中更坚固：分段 WebUI 转录、一流的 Python SDK 运行时控制、自动化管理、更丰富的搜索/STT 提供商，以及更强的网关/会话/提供商可靠性。详情请见 发布说明。
• 2026-06-21 🧰 Python SDK 运行时控制、可选的 Keenable 密钥、更清晰的运行钩子。
• 2026-06-20 💬 Telegram 富媒体消息、更安全的 SDK 并发、更流畅的快速入门。
• 2026-06-19 🔎 Firecrawl 应用、OpenAI 图像编辑、更安全的会话删除。
• 2026-06-18 💬 飞书恢复、Keenable 搜索、Mistral 打磨、工作区感知的 git。
• 2026-06-17 🧠 默认空闲自动压缩、更清晰的 /dream、macOS 安装程序修复。
• 2026-06-16 🎯 更新的目标上下文、Kimi K2.7 思维、更干净的 API 重试。
• 2026-06-15 📱 移动端 WebUI 打磨、可选文件工具、真实 API 用量。
• 2026-06-14 🖼️ 主题封面、合作伙伴链接、更强的 Codex 图像流式传输。
• 2026-06-13 🗓️ 绑定的会话自动化、更稳健的 WhatsApp、更快的 WebUI 启动。

更早的新闻

• 2026-06-12 💬 Slack 白名单频道可以要求被提及。
• 2026-06-11 ✂️ 代码块分割消息。
• 2026-06-10 📜 分段转录、Exa/Bocha 搜索、StepFun/SiliconFlow ASR。
• 2026-06-09 🎙️ 共享语音输入、更多 STT 提供商、TeX 和邮件打磨。
• 2026-06-08 🧮 Token 热度图修复、更安全的 MCP HTTP 探测、文档清理。
• 2026-06-06 🧰 SDK MCP 清理、可移除 OpenAI 图像默认值。
• 2026-06-05 🖼️ Azure AAD、自定义图像提供商、/skill、更稳定的配对。
• 2026-06-04 🔌 MCP 重连、uv pip 安装回退、QQ 配对。
• 2026-06-03 🧠 隐藏历史恢复、更安静的邮件进度处理。
• 2026-06-02 📬 邮件附件、Napcat QQ、火山引擎搜索、更简单的 Dream。
• 2026-06-01 🚀 发布 v0.2.1 — 工作台发布 将打包的 WebUI 转变为日常代理工作台：更清晰的 Thought/响应时间线、实时文件编辑活动、项目工作区、模型与上下文控制、更稳定的持续目标、CLI 应用 + MCP 扩展，以及更广泛的提供商/频道支持。详情请见 发布说明。
• 2026-05-30 🔐 更安全的 Matrix 验证、受限媒体下载、更清晰的 WebUI 模型时间线。
• 2026-05-29 🧩 扩展注册表、上下文窗口调优、文档提取控制。
• 2026-05-28 🗂️ 项目工作区、访问控制、更稳定的目标与流式传输。
• 2026-05-27 ⏱️ Codex 流在长时间运行中遵循空闲超时。
• 2026-05-26 📡 Telegram webhooks、刷新 Kagi 搜索、更干净的传输错误。
• 2026-05-25 🔌 统一 CLI 应用与 MCP、Step Plan 支持、更稳定的持续目标。
• 2026-05-24 🧰 MCP 预设、更丰富的斜杠操作、可配置的 OpenAI 兼容请求。
• 2026-05-23 🖼️ 智谱图像生成、更长的执行窗口、更清晰的转录配置。
• 2026-05-22 🛠️ CLI 应用、更多图像提供商、更安全的网页重定向和编辑。
• 2026-05-21 ⚡ Novita 提供商、更快的侧栏、更流畅的编码工具和微信回复。
• 2026-05-20 📶 Signal 频道、更快的网关启动、多语言 README 链接。
• 2026-05-19 🎨 图像提供商注册表、StepFun 与 Skywork、更强的 WebUI 控制。
• 2026-05-18 🖌️ Gemini 与 MiniMax 图像、Ant Ling、实时文件编辑活动。
• 2026-05-17 🌊 更流畅的 WebUI 流式传输、AutoCompact 修复、缓冲的 CLI 推理。
• 2026-05-16 🧠 Atomic Chat 提供商、目标感知超时、更安全的 exec URL 处理。
• 2026-05-15 🚀 发布 v0.2.0 — /goal 跨轮次维持持续目标，WebUI 现内置在 wheel 中，端到端图像生成，5 个新提供商与 fallback_models，以及真正的代理循环重构。详情请见 发布说明。
• 2026-05-14 🎯 /goal 支持长期目标、可视化多步骤进度、聊天中的长周期任务。
• 2026-05-13 🧠 在答案前流式推理、自动备份模型、更流畅的插件重连。
• 2026-05-12 🎛️ 保存的模型预设与 WebUI 徽章、更简单的插件工具、更安静的飞书话题线程。
• 2026-05-11 🖥️ NVIDIA NIM 支持、终端机器人名称与图标、流式推理与 MiMo 切换清晰度。
• 2026-05-09 🖼️ 更清晰的图像回放、在设置中自带 Web 搜索密钥、飞书线程清洁路由。
• 2026-05-08 ✨ 内嵌聊天图片、重新设计的设置与密钥、与可见历史对齐的 Dream 记忆。
• 2026-05-07 📜 WebUI 中本地感知的斜杠菜单、局域网登录、忠实的 HTTP 流式响应。
• 2026-05-06 🧩 可调工具提示、更稳定的语音和插件启动、持久化计划与提醒。
• 2026-05-05 🛡️ 对未知 Telegram 聊天的静默拒绝、Dream 清理、更完整的自动化摘要。
• 2026-05-04 🔐 更安全的钉钉外发媒体链接、持久的 cron 持久化、DeepSeek 打磨。
• 2026-05-03 ⚙️ 可预测的 shell 白名单行为、回复中途隔离会话、更干净的交互式重试。
• 2026-05-02 🐈 LongCat 支持、更智能的令牌大小提示、更清晰的内置升级指南。
• 2026-05-01 ☁️ 原生 AWS Bedrock 提供商、更紧密的助手交接与限域会话文件。
• 2026-04-30 💬 飞书线程尊重回复与话题、WhatsApp 桥接在源编辑时刷新。
• 2026-04-29 🚀 发布 v0.1.5.post3 — 更智能的飞书、Discord、Slack 和 Teams 线程；DeepSeek-V4 ；Hugging Face 与 Olostep；选项、/history 和更稳定的长对话。详情请见 发布说明。
• 2026-04-28 🌐 Olostep 网页搜索、Hugging Face 提供商、更安全的工作区工具中断。
• 2026-04-27 💬 /history 命令、更智能的会话回放上限、更流畅的 Discord/Slack 线程。
• 2026-04-26 🧭 自然语言 cron 提醒、线程感知重启、更安全的本地提供商与 shell 行为。
• 2026-04-25 🧩 ask_user 选项、macOS LaunchAgent 部署、MSTeams 旧引用清理。
• 2026-04-24 🎥 频道的视频附件、DeepSeek 思维控制、更快的文档启动。
• 2026-04-23 🧵 Discord 线程会话、Telegram 内联按钮、结构化的工具进度更新。
• 2026-04-22 🔎 GitHub Copilot GPT-5 / o-series 支持、可配置的网页抓取、WebUI 图片上传。
• 2026-04-21 🚀 发布 v0.1.5.post2 — Windows 与 Python 3.14 支持、Office 文档阅读、OpenAI 兼容 API 的 SSE 流式传输，以及会话、记忆和频道可靠性增强。详情请见 发布说明。
• 2026-04-20 🎨 Kimi K2.6 支持、Telegram 长消息拆分、WebUI 排版与暗黑模式打磨。
• 2026-04-19 🌐 WebUI 国际化语言切换器、原子化会话写入及自动修复。
• 2026-04-18 🧪 初始 WebUI 聊天、更智能的设置向导菜单、WebSocket 多聊天多路复用。
• 2026-04-17 🪟 Windows 与 Python 3.14 CI、Dream 行级记忆、邮件自循环保护。
• 2026-04-16 📡 OpenAI 兼容 API 的 SSE 流式传输、Discord 频道白名单。
• 2026-04-15 🎛️ LM Studio 与可空 API 密钥、MiniMax 思维端点、运行时 SelfTool。
• 2026-04-14 🚀 发布 v0.1.5.post1 — Dream 技能发现、轮次中后续注入、WebSocket 频道以及更深入的频道集成。详情请见 发布说明。
• 2026-04-13 🛡️ 代理轮次加固 — 用户消息提前持久化，自动压缩跳过活动任务。
• 2026-04-12 🔒 Lark 全局域名支持、Dream 学习已发现的技能、shell 沙箱收紧。
• 2026-04-11 ⚡ 上下文压缩动态缩减会话；Kagi 网页搜索；QQ 与 WeCom 全媒体。
• 2026-04-10 📓 多个 MCP 服务器、飞书流式传输与完成表情符。
• 2026-04-09 🔌 WebSocket 频道、统一跨频道会话、disabled_skills 配置。
• 2026-04-08 📤 API 文件上传、OpenAI 推理自动路由与 Responses 回退。
• 2026-04-07 🧠 Anthropic 自适应思维、MCP 资源与提示以工具形式暴露。
• 2026-04-06 🛰️ Langfuse 可观察性、统一的 Whisper 转录、邮件附件。
• 2026-04-05 🚀 发布 v0.1.5 — 更稳健的长时间运行任务、Dream 两阶段记忆、可投入生产的沙箱和编程代理 SDK。详情请见 发布说明。
• 2026-04-04 🚀 Jinja2 响应模板、Dream 记忆加固、更智能的重试处理。
• 2026-04-03 🧠 小米 MiMo 提供商、思维链推理可见、Telegram 用户体验打磨。
• 2026-04-02 🧱 长时间运行任务更可靠 — 核心运行时加固。
• 2026-04-01 🔑 GitHub Copilot 认证恢复；更严格的工作区路径；OpenRouter Claude 缓存修复。
• 2026-03-31 🛰️ 微信多模态对齐、Discord/Matrix 打磨、Python SDK 外观、MCP 与工具修复。
• 2026-03-30 🧩 OpenAI 兼容 API 收紧；可组合的代理生命周期钩子。
• 2026-03-29 💬 微信语音、输入状态、二维码/媒体适应力；固定会话的 OpenAI 兼容 API。
• 2026-03-28 📚 提供商文档刷新；技能模板措辞修正。
• 2026-03-27 🚀 发布 v0.1.4.post6 — 架构解耦、移除 litellm、端到端流式传输、微信频道和安全修复。详情请见 发布说明。
• 2026-03-26 🏗️ 提取代理运行器并统一生命周期钩子；在边界合并流增量。
• 2026-03-25 🌏 StepFun 提供商、可配置时区、Gemini 思维签名。
• 2026-03-24 🔧 微信兼容性、飞书 CardKit 流式传输、测试套件重构。
• 2026-03-23 🔧 为插件重构命令路由、WhatsApp/微信媒体、统一频道登录 CLI。
• 2026-03-22 ⚡ 端到端流式传输、微信频道、Anthropic 缓存优化、/status 命令。
• 2026-03-21 🔒 用原生 openai 和 anthropic SDK 替换 litellm。请见 提交。
• 2026-03-20 🧙 交互式设置向导 — 选择你的提供商，模型自动补全，即可开始使用。
• 2026-03-19 💬 Telegram 在高负载下更具弹性；飞书现在正确渲染代码块。
• 2026-03-18 📷 Telegram 现在可以通过 URL 发送媒体。Cron 计划显示可读的细节。
• 2026-03-17 ✨ 飞书格式化焕新、Slack 完成时反应、自定义端点支持额外头信息以及图像处理更可靠。
• 2026-03-16 🚀 发布 v0.1.4.post5 — 一个以改进为重点的发布，具有更强的可靠性和频道支持，以及更可靠的日常使用体验。详情请见 发布说明。
• 2026-03-15 🧩 钉钉富媒体、更智能的内置技能以及更干净的模型兼容性。
• 2026-03-14 💬 频道插件、飞书回复以及更稳定的 MCP、QQ 和媒体处理。
• 2026-03-13 🌐 多提供商网页搜索、LangSmith 以及更广泛的可靠性改进。
• 2026-03-12 🚀 火山引擎支持、Telegram 回复上下文、/restart 以及更坚固的记忆。
• 2026-03-11 🔌 WeCom、Ollama、更干净的发现以及更安全的工具行为。
• 2026-03-10 🧠 基于令牌的记忆、共享重试以及更干净的网关和 Telegram 行为。
• 2026-03-09 💬 Slack 线程打磨和更佳的飞书音频兼容性。
• 2026-03-08 🚀 发布 v0.1.4.post4 — 一个充满可靠性改进的发布，具有更安全的默认设置、更好的多实例支持、更坚固的 MCP 以及较大的频道和提供商增强。

🐈 nanobot is an open-source, ultra-lightweight personal AI agent you can truly own. It keeps the agent core small and readable while giving you the practical pieces for real long-running work: WebUI, chat channels, tools, memory, MCP, model routing, automation, and deployment.

You want to...	Go to
Install nanobot with no terminal/config background	Start Without Technical Background
Install quickly and get one CLI reply	Install and Quick Start
Open the bundled browser UI	WebUI
Connect Telegram, Discord, WeChat, Slack, Email, Mattermost, or another chat app	Chat Apps
Configure providers, fallback models, Langfuse, MCP, web tools, or security	Docs and Configuration
Understand or extend the internals	Architecture and Development

• 2026-06-22 🚀 Released v0.2.2 — The Durability Release makes nanobot sturdier for daily agent work: segmented WebUI transcripts, first-class Python SDK runtime controls, automation management, richer search/STT providers, and stronger gateway/session/provider reliability. Please see release notes for details.
• 2026-06-21 🧰 Python SDK runtime controls, optional Keenable key, cleaner run hooks.
• 2026-06-20 💬 Telegram rich messages, safer SDK concurrency, smoother Quick Start.
• 2026-06-19 🔎 Firecrawl app, OpenAI image edits, safer session deletion.
• 2026-06-18 💬 Feishu recovery, Keenable search, Mistral polish, workspace-aware git.
• 2026-06-17 🧠 Default idle auto-compact, clearer /dream, macOS installer fixes.
• 2026-06-16 🎯 Fresher goal context, Kimi K2.7 thinking, cleaner API retries.
• 2026-06-15 📱 Mobile WebUI polish, optional file tools, real API usage.
• 2026-06-14 🖼️ Themed cover, partner links, stronger Codex image streaming.
• 2026-06-13 🗓️ Session-bound automations, sturdier WhatsApp, faster WebUI startup.

Earlier news

• 2026-06-12 💬 Slack allowlisted channels can require mentions.

• 2026-06-11 ✂️ Fenced-code message splitting.

• 2026-06-10 📜 Segmented transcripts, Exa/Bocha search, StepFun/SiliconFlow ASR.

• 2026-06-09 🎙️ Shared voice input, more STT providers, TeX and email polish.

• 2026-06-08 🧮 Token heatmap fix, safer MCP HTTP probing, docs cleanup.

• 2026-06-06 🧰 SDK MCP cleanup, removable OpenAI image defaults.

• 2026-06-05 🖼️ Azure AAD, custom image providers, /skill, steadier pairing.

• 2026-06-04 🔌 MCP reconnects, uv pip install fallback, QQ pairing.

• 2026-06-03 🧠 Hidden-history recovery, quieter email progress handling.

• 2026-06-02 📬 Email attachments, Napcat QQ, Volcengine search, simpler Dream.

• 2026-06-01 🚀 Released v0.2.1 — The Workbench Release turns the packaged WebUI into a daily agent workbench: clearer Thought/response timelines, live file-edit activity, project workspaces, model and context controls, steadier sustained goals, CLI Apps + MCP extensions, and broader provider/channel support. Please see release notes for details.

• 2026-05-30 🔐 Safer Matrix verification, bounded media downloads, clearer WebUI model timeline.

• 2026-05-29 🧩 Extension registry, context-window tuning, document extraction controls.

• 2026-05-28 🗂️ Project workspaces, access controls, steadier goals and streaming.

• 2026-05-27 ⏱️ Codex streams respect idle timeouts during long runs.

• 2026-05-26 📡 Telegram webhooks, refreshed Kagi search, cleaner transport errors.

• 2026-05-25 🔌 Unified CLI Apps and MCP, Step Plan support, steadier sustained goals.

• 2026-05-24 🧰 MCP presets, richer slash actions, configurable OpenAI-compatible requests.

• 2026-05-23 🖼️ Zhipu image generation, longer exec windows, cleaner transcription config.

• 2026-05-22 🛠️ CLI Apps, more image providers, safer web redirects and edits.

• 2026-05-21 ⚡ Novita provider, faster sidebar, smoother coding tools and Weixin replies.

• 2026-05-20 📶 Signal channel, faster gateway startup, multilingual README links.

• 2026-05-19 🎨 Image provider registry, StepFun and Skywork, stronger WebUI controls.

• 2026-05-18 🖌️ Gemini and MiniMax images, Ant Ling, live file-edit activity.

• 2026-05-17 🌊 Smoother WebUI streaming, AutoCompact fixes, buffered CLI reasoning.

• 2026-05-16 🧠 Atomic Chat provider, goal-aware timeouts, safer exec URL handling.

• 2026-05-15 🚀 Released v0.2.0 — /goal holds sustained objectives across turns, WebUI now ships inside the wheel, image generation end to end, 5 new providers with fallback_models, and a real agent-loop refactor. Please see release notes for details.

• 2026-05-14 🎯 /goal for long-term objectives, visible multi-step progress, long-horizon missions in chat.

• 2026-05-13 🧠 Streaming reasoning before answers, automatic backup models, smoother plug-in reconnects.

• 2026-05-12 🎛️ Saved model presets with WebUI badge, simpler plug-in tools, quieter Feishu topic threads.

• 2026-05-11 🖥️ NVIDIA NIM support, terminal bot name and icon, streamed reasoning and MiMo toggle clarity.

• 2026-05-09 🖼️ Sharper image replay, BYO web-search keys in Settings, Feishu threads routed cleanly.

• 2026-05-08 ✨ Inline chat image, redesigned Settings and keys, Dream memory aligned with visible history.

• 2026-05-07 📜 Locale-aware slash palette in WebUI, LAN login, faithful HTTP streaming responses.

• 2026-05-06 🧩 Tunable tool hint, steadier voice and plug-in startups, schedules and reminders that stick.

• 2026-05-05 🛡️ Quiet deny for unknown Telegram chats, Dream cleanup, fuller automation summaries.

• 2026-05-04 🔐 Safer DingTalk outbound media links, durable cron persistence, DeepSeek polish.

• 2026-05-03 ⚙️ Predictable shell allow-list behavior, isolated chats mid-reply, cleaner interactive retries.

• 2026-05-02 🐈 LongCat support, smarter token sizing hints, clearer bundled upgrade guidance.

• 2026-05-01 ☁️ Native AWS Bedrock provider, tighter helper handoffs and scoped session files.

• 2026-04-30 💬 Feishu threads that honor replies and topics, WhatsApp bridge refresh on source edits.

• 2026-04-29 🚀 Released v0.1.5.post3 — Smarter threads on Feishu, Discord, Slack, and Teams; DeepSeek-V4 ; Hugging Face & Olostep; choices, /history, and steadier long chats. Please see release notes for details.

• 2026-04-28 🌐 Olostep web search, Hugging Face provider, safer workspace-tool interruptions.

• 2026-04-27 💬 /history command, smarter session replay caps, smoother Discord / Slack threads.

• 2026-04-26 🧭 Natural cron reminders, thread-aware restarts, safer local provider and shell behavior.

• 2026-04-25 🧩 ask_user choices, macOS LaunchAgent deployment, MSTeams stale-reference cleanup.

• 2026-04-24 🎥 Video attachments for channels, DeepSeek thinking control, faster document startup.

• 2026-04-23 🧵 Discord thread sessions, Telegram inline buttons, structured tool progress updates.

• 2026-04-22 🔎 GitHub Copilot GPT-5 / o-series support, configurable web fetch, WebUI image uploads.

• 2026-04-21 🚀 Released v0.1.5.post2 — Windows & Python 3.14 support, Office document reading, SSE streaming for the OpenAI-compatible API, and stronger reliability across sessions, memory, and channels. Please see release notes for details.

• 2026-04-20 🎨 Kimi K2.6 support, Telegram long-message split, WebUI typography & dark-mode polish.

• 2026-04-19 🌐 WebUI i18n locale switcher, atomic session writes with auto-repair.

• 2026-04-18 🧪 Initial WebUI chat, smarter setup wizard menus, WebSocket multi-chat multiplexing.

• 2026-04-17 🪟 Windows & Python 3.14 CI, Dream line-age memory, email self-loop guard.

• 2026-04-16 📡 SSE streaming for OpenAI-compatible API, Discord channel allow-list.

• 2026-04-15 🎛️ LM Studio & nullable API keys, MiniMax thinking endpoint, runtime SelfTool.

• 2026-04-14 🚀 Released v0.1.5.post1 — Dream skill discovery, mid-turn follow-up injection, WebSocket channel, and deeper channel integrations. Please see release notes for details.

• 2026-04-13 🛡️ Agent turn hardened — user messages persisted early, auto-compact skips active tasks.

• 2026-04-12 🔒 Lark global domain support, Dream learns discovered skills, shell sandbox tightened.

• 2026-04-11 ⚡ Context compact shrinks sessions on the fly; Kagi web search; QQ & WeCom full media.

• 2026-04-10 📓 Multiple MCP servers, Feishu streaming & done-emoji.

• 2026-04-09 🔌 WebSocket channel, unified cross-channel session, disabled_skills config.

• 2026-04-08 📤 API file uploads, OpenAI reasoning auto-routing with Responses fallback.

• 2026-04-07 🧠 Anthropic adaptive thinking, MCP resources & prompts exposed as tools.

• 2026-04-06 🛰️ Langfuse observability, unified Whisper transcription, email attachments.

• 2026-04-05 🚀 Released v0.1.5 — sturdier long-running tasks, Dream two-stage memory, production-ready sandboxing and programming Agent SDK. Please see release notes for details.

• 2026-04-04 🚀 Jinja2 response templates, Dream memory hardened, smarter retry handling.

• 2026-04-03 🧠 Xiaomi MiMo provider, chain-of-thought reasoning visible, Telegram UX polish.

• 2026-04-02 🧱 Long-running tasks run more reliably — core runtime hardening.

• 2026-04-01 🔑 GitHub Copilot auth restored; stricter workspace paths; OpenRouter Claude caching fix.

• 2026-03-31 🛰️ WeChat multimodal alignment, Discord/Matrix polish, Python SDK facade, MCP and tool fixes.

• 2026-03-30 🧩 OpenAI-compatible API tightened; composable agent lifecycle hooks.

• 2026-03-29 💬 WeChat voice, typing, QR/media resilience; fixed-session OpenAI-compatible API.

• 2026-03-28 📚 Provider docs refresh; skill template wording fix.

• 2026-03-27 🚀 Released v0.1.4.post6 — architecture decoupling, litellm removal, end-to-end streaming, WeChat channel, and a security fix. Please see release notes for details.

• 2026-03-26 🏗️ Agent runner extracted and lifecycle hooks unified; stream delta coalescing at boundaries.

• 2026-03-25 🌏 StepFun provider, configurable timezone, Gemini thought signatures.

• 2026-03-24 🔧 WeChat compatibility, Feishu CardKit streaming, test suite restructured.

• 2026-03-23 🔧 Command routing refactored for plugins, WhatsApp/WeChat media, unified channel login CLI.

• 2026-03-22 ⚡ End-to-end streaming, WeChat channel, Anthropic cache optimization, /status command.

• 2026-03-21 🔒 Replace litellm with native openai + anthropic SDKs. Please see commit.

• 2026-03-20 🧙 Interactive setup wizard — pick your provider, model autocomplete, and you're good to go.

• 2026-03-19 💬 Telegram gets more resilient under load; Feishu now renders code blocks properly.

• 2026-03-18 📷 Telegram can now send media via URL. Cron schedules show human-readable details.

• 2026-03-17 ✨ Feishu formatting glow-up, Slack reacts when done, custom endpoints support extra headers, and image handling is more reliable.

• 2026-03-16 🚀 Released v0.1.4.post5 — a refinement-focused release with stronger reliability and channel support, and a more dependable day-to-day experience. Please see release notes for details.

• 2026-03-15 🧩 DingTalk rich media, smarter built-in skills, and cleaner model compatibility.

• 2026-03-14 💬 Channel plugins, Feishu replies, and steadier MCP, QQ, and media handling.

• 2026-03-13 🌐 Multi-provider web search, LangSmith, and broader reliability improvements.

• 2026-03-12 🚀 VolcEngine support, Telegram reply context, /restart, and sturdier memory.

• 2026-03-11 🔌 WeCom, Ollama, cleaner discovery, and safer tool behavior.

• 2026-03-10 🧠 Token-based memory, shared retries, and cleaner gateway and Telegram behavior.

• 2026-03-09 💬 Slack thread polish and better Feishu audio compatibility.

• 2026-03-08 🚀 Released v0.1.4.post4 — a reliability-packed release with safer defaults, better multi-instance support, sturdier MCP, and major channel and provider improvements. Please see release notes for details.

• 2026-03-07 🚀 Azure OpenAI provider, WhatsApp media, QQ group chats, and more Telegram/Feishu polish.

• 2026-03-06 🪄 Lighter providers, smarter media handling, and sturdier memory and CLI compatibility.

• 2026-03-05 ⚡️ Telegram draft streaming, MCP SSE support, and broader channel reliability fixes.

• 2026-03-04 🛠️ Dependency cleanup, safer file reads, and another round of test and Cron fixes.

• 2026-03-03 🧠 Cleaner user-message merging, safer multimodal saves, and stronger Cron guards.

• 2026-03-02 🛡️ Safer default access control, sturdier Cron reloads, and cleaner Matrix media handling.

• 2026-03-01 🌐 Web proxy support, smarter Cron reminders, and Feishu rich-text parsing improvements.

• 2026-02-28 🚀 Released v0.1.4.post3 — cleaner context, hardened session history, and smarter agent. Please see release notes for details.

• 2026-02-27 🧠 Experimental thinking mode support, DingTalk media messages, Feishu and QQ channel fixes.

• 2026-02-26 🛡️ Session poisoning fix, WhatsApp dedup, Windows path guard, Mistral compatibility.

• 2026-02-25 🧹 New Matrix channel, cleaner session context, auto workspace template sync.

• 2026-02-24 🚀 Released v0.1.4.post2 — a reliability-focused release with a redesigned heartbeat, prompt cache optimization, and hardened provider & channel stability. See release notes for details.

• 2026-02-23 🔧 Virtual tool-call heartbeat, prompt cache optimization, Slack mrkdwn fixes.

• 2026-02-22 🛡️ Slack thread isolation, Discord typing fix, agent reliability improvements.

• 2026-02-21 🎉 Released v0.1.4.post1 — new providers, media support across channels, and major stability improvements. See release notes for details.

• 2026-02-20 🐦 Feishu now receives multimodal files from users. More reliable memory under the hood.

• 2026-02-19 ✨ Slack now sends files, Discord splits long messages, and subagents work in CLI mode.

• 2026-02-18 ⚡️ nanobot now supports VolcEngine, MCP custom auth headers, and Anthropic prompt caching.

• 2026-02-17 🎉 Released v0.1.4 — MCP support, progress streaming, new providers, and multiple channel improvements. Please see release notes for details.

• 2026-02-16 🦞 nanobot now integrates a ClawHub skill — search and install public agent skills.

• 2026-02-15 🔑 nanobot now supports OpenAI Codex provider with OAuth login support.

• 2026-02-14 🔌 nanobot now supports MCP! See MCP section for details.

• 2026-02-13 🎉 Released v0.1.3.post7 — includes security hardening and multiple improvements. Please upgrade to the latest version to address security issues. See release notes for more details.

• 2026-02-12 🧠 Redesigned memory system — Less code, more reliable. Join the discussion about it!

• 2026-02-11 ✨ Enhanced CLI experience and added MiniMax support!

• 2026-02-10 🎉 Released v0.1.3.post6 with improvements! Check the updates notes and our roadmap.

• 2026-02-09 💬 Added Slack, Email, and QQ support — nanobot now supports multiple chat platforms!

• 2026-02-08 🔧 Refactored Providers—adding a new LLM provider now takes just 2 simple steps! Check here.

• 2026-02-07 🚀 Released v0.1.3.post5 with Qwen support & several key improvements! Check here for details.

• 2026-02-06 ✨ Added Moonshot/Kimi provider, Discord integration, and enhanced security hardening!

• 2026-02-05 ✨ Added Feishu channel, DeepSeek provider, and enhanced scheduled tasks support!

• 2026-02-04 🚀 Released v0.1.3.post4 with multi-provider & Docker support! Check here for details.

• 2026-02-03 ⚡ Integrated vLLM for local LLM support and improved natural language task scheduling!

• 2026-02-02 🎉 nanobot officially launched! Welcome to try 🐈 nanobot!

• Persistent workflows : goals, memory, tools, and chat context survive long-running work.

• Chat-native reach : WebUI, API, Telegram, Feishu, Slack, Discord, Teams, email, and Mattermost.

• Model freedom : OpenAI-compatible APIs, local LLMs, image generation, search, and fallbacks.

• Small core : readable internals with MCP, memory, deployment, and automation built in.

• Own your stack : inspect, customize, self-host, and extend without a giant platform.

Important

If you want the newest features and experiments, install from source.

If you want the most stable day-to-day experience, install from PyPI or with uv.

Pick one install method:

Prerequisites: Python 3.11 or newer. Git is only needed for a source install; Node.js/Bun are only needed if you are developing the WebUI itself.

If terminals, API keys, or config files are new to you, use the guided zero-background walkthrough in Start Without Technical Background instead of this compact README path.

One-command setup

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex

The default command installs or upgrades nanobot-ai from PyPI, then starts nanobot onboard --wizard. It avoids system-wide pip installs by using an active virtual environment, uv, pipx, or a managed venv under ~/.nanobot/venv. If Quick Start finishes, skip the manual initialize/configure steps below and go straight to Open the WebUI.

To preview the plan without changing your environment, pass --dry-run; combine it with --dev when you want to preview the main-branch install.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run


& ([scriptblock]::Create((irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1))) --dry-run

To install the current main branch instead, pass --dev:

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dev


& ([scriptblock]::Create((irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1))) --dev

If you prefer to inspect the script first, open scripts/install.sh or scripts/install.ps1.

Install withuv

uv tool install nanobot-ai

Install from PyPI with pip

python -m pip install nanobot-ai

If pip reports externally-managed-environment on macOS or Linux, use the one-command installer, uv tool install nanobot-ai, pipx install nanobot-ai, or install inside a virtual environment.

Install from source

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
python -m pip install -e .

Verify the install:

1. Initialize

Skip this step if the one-command setup already started the wizard and Quick Start finished there.

Use nanobot onboard --wizard if you prefer an interactive setup.

2. Configure (~/.nanobot/config.json)

Skip this step if you already configured provider and model settings in the wizard.

nanobot onboard creates ~/.nanobot/config.json and ~/.nanobot/workspace/. Configure these two parts in the config file. Add or merge the following blocks into the existing file instead of replacing the whole file.

The example below uses a generic OpenAI-compatible custom provider so the compact path does not recommend one hosted service. Provider examples are recipes, not rankings or endorsements. For copyable provider-specific setup, see Provider Cookbook.

Set your API key :

{
  "providers": {
    "custom": {
      "apiKey": "your-api-key",
      "apiBase": "https://api.example.com/v1"
    }
  }
}

Set a model preset and make it active :

{
  "modelPresets": {
    "primary": {
      "label": "Primary",
      "provider": "custom",
      "model": "model-id-from-your-provider",
      "maxTokens": 8192,
      "contextWindowTokens": 200000,
      "temperature": 0.1
    }
  },
  "agents": {
    "defaults": {
      "modelPreset": "primary"
    }
  }
}

Direct agents.defaults.provider and agents.defaults.model still work for existing configs, but named presets are the recommended path because they also power /model switching and fallbackModels.

For another provider, the same config shape still applies:

Replace	Where
Provider config key	providers.<provider>
API key	providers.<provider>.apiKey
Preset provider name	modelPresets.primary.provider
Model ID	modelPresets.primary.model
Endpoint URL, only when needed	providers.<provider>.apiBase

3. Open the WebUI

Start the browser workbench:

nanobot webui prepares the local WebSocket channel if needed, starts the gateway, and opens http://127.0.0.1:8765. It binds the first-run WebUI to 127.0.0.1 by default, so it is not exposed to your LAN. Prefer not to keep a terminal open? Use nanobot webui --background, then manage the gateway with nanobot gateway status, logs, restart, and stop.

For manual or terminal-only setup, test one CLI message:

nanobot status
nanobot agent -m "Hello!"

In nanobot status, it is normal for most providers to say not set. The active preset's provider should be configured, and Config plus Workspace should show check marks.

If that works, start an interactive chat:

Need help with PATH, API keys, provider/model matching, or JSON errors? See the fuller Install and Quick Start and Troubleshooting.

The WebUI ships inside the published wheel — no extra build step. It is the browser workbench for chat sessions, workspace controls, Apps, Skills, Automations, and settings. For the full user guide, see docs/webui.md.

Open it

The command enables the local WebSocket channel after confirmation, starts the gateway, and opens http://127.0.0.1:8765. To open it from another device on your LAN, see WebUI docs -> LAN access.

The WebUI is served by the WebSocket channel on port 8765 by default. The gateway's 18790 port is for the health endpoint, not the browser UI.

Tip

Working on the WebUI itself? Check out webui/README.md for the source-tree, Vite dev server, build, and test workflow.

🐈 nanobot stays lightweight by centering everything around a small agent loop: messages come in from chat apps, the LLM decides when tools are needed, and memory or skills are pulled in only as context instead of becoming a heavy orchestration layer. That keeps the core path readable and easy to extend, while still letting you add channels, tools, memory, and deployment options without turning the system into a monolith.

📈 24/7 Real-Time Market Analysis	🚀 Full-Stack Software Engineer	📅 Smart Daily Routine Manager	📚 Personal Knowledge Assistant
Discovery • Insights • Trends	Develop • Deploy • Scale	Schedule • Automate • Organize	Learn • Memory • Reasoning

Browse the repo docs for the latest features and GitHub development version, or visit nanobot.wiki for the stable release documentation.

PRs welcome! The codebase is intentionally small and readable. 🤗

See CONTRIBUTING.md for setup, review, and contribution guidelines.

Roadmap — Pick an item and open a PR!

• Multi-modal — See and hear (images, voice, video)
• Long-term memory — Never forget important context
• Better reasoning — Multi-step planning and reflection
• More integrations — Calendar and more
• Self-improvement — Learn from feedback and mistakes

This project was started by Xubin Ren as a personal open-source project and continues to be maintained in an individual capacity using personal resources, with contributions from the open-source community. Feel free to contact xubinrencs@gmail.com for questions, ideas, or collaboration.

Thanks for visiting ✨ nanobot!