hkuds/nanobot

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and...

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 11 minutes ago
Added to GitGenius on August 31st, 2026
Created on February 1st, 2026
Open Issues & Pull Requests: 758 (+0)
Number of forks: 8,396
Total Stargazers: 47,576 (+0)
Total Subscribers: 208 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 11.9 hours
Mean response time: 10.1 days
90th percentile: 32.0 days
Tracked items: 1,390

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 99% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. 40% of tracked open issues have had no activity in three months. Only 12% of issues opened in the past year have been closed. Three people close 84% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 209
New in 7 days: 20
Closed in 7 days: 7
Avg open age: 120 days
Stale 30+ days: 153
Stale 90+ days: 82

Recent activity

Opened in 7 days: 13
Closed in 7 days: 7
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • bug (171)
  • enhancement (125)
  • stale (44)
  • good first issue (42)
  • feature request (40)
  • question (19)
  • regression (8)
  • duplicate (5)

Detailed Description

Nanobot is a personal AI agent framework that runs as a self-hosted Python application with a WebUI, terminal interface, and chat app integrations.

The framework addresses the need for a lightweight, self-contained AI agent system by combining several capabilities in a single core: tool execution, long-term memory persistence, Model Context Protocol integrations, model routing across different LLMs, multi-agent workflows with delegation, and scheduled automation. It exposes an OpenAI-compatible API, allowing it to work with existing tooling and clients designed for that interface. The codebase is designed to be small and readable, making it accessible for developers who want to understand or modify their AI agent infrastructure.

Nanobot suits developers and individuals who want to self-host their AI agent infrastructure without external dependencies, prefer Python-based systems they can inspect and extend, or need to run agents locally with privacy guarantees. It works well for personal automation, multi-agent workflows, and scenarios where chat app integration (Discord, Telegram) or scheduled task execution is required. The project positions itself as an alternative to heavier frameworks by emphasizing its lightweight footprint and readable implementation.

The project maintains an active test suite with continuous integration. Documentation is comprehensive and available in multiple languages. The codebase demonstrates consistent maintenance with a focus on stability and accessibility for contributors seeking to understand or extend the framework.