nanobot  by nanobot-ai

Standalone MCP host for building AI agents

Created 6 months ago
655 stars

Top 51.2% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Nanobot offers a flexible, standalone, open-source MCP host for building agents with MCP and MCP-UI. It targets developers aiming to create custom, dedicated chatbot experiences, providing an alternative to integrated hosts found in other applications. Nanobot enables easy deployment and integration for building bespoke MCP/MCP-UI powered chatbots.

How It Works

Nanobot functions as an MCP host, integrating MCP servers with an LLM and context for agent interaction. Its core design is a flexible, standalone, open-source platform deployable or embeddable into other applications. This approach facilitates custom chat interfaces or other interaction modalities (voice, SMS, AR/VR) powered by MCP and MCP-UI.

Quick Start & Requirements

  • Installation: Homebrew: brew install nanobot-ai/tap/nanobot for the CLI.
  • Prerequisites: Set LLM API keys (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY).
  • Configuration: Define agents and MCP servers in nanobot.yaml.
  • Running: Execute nanobot run ./nanobot.yaml; UI available at http://localhost:8080.
  • Development: Build from source via make. UI development: cd ui, rm -rf ./ui/dist, make, cd ui && npm run dev.

Highlighted Details

  • MCP Compliance: Aims for full MCP + MCP-UI feature compliance, with a roadmap tracking progress.
  • Example Integrations: Showcases Blackjack Game, Hugging Face MCP, and Shopping/Shopify use cases.
  • UI Development: Supports separate UI development, forwarding from port 8080 to UI's dev server (5173).
  • Roadmap: Includes plans for full MCP/MCP-UI compliance, multi-agent support, production UI, expanded model/auth support, and frontend integrations.

Maintenance & Community

Nanobot is in alpha, expecting active development and rapid changes. Contributions are welcomed. Project links include its website (nanobot.ai) and GitHub repository (github.com/nanobot-ai/nanobot).

Licensing & Compatibility

Licensed under the Apache 2.0 License, permitting commercial use and integration with closed-source applications.

Limitations & Caveats

As an alpha project, Nanobot is subject to rapid changes. Some features are marked as partial or not yet implemented, indicating ongoing development and potential instability.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
7
Issues (30d)
1
Star History
31 stars in the last 30 days

Explore Similar Projects

Starred by Andrew Ng Andrew Ng(Founder of DeepLearning.AI; Cofounder of Coursera; Professor at Stanford), Thomas Wolf Thomas Wolf(Cofounder of Hugging Face), and
4 more.

ag2 by ag2ai

0.7%
4k
AgentOS for building AI agents and facilitating multi-agent cooperation
Created 1 year ago
Updated 3 days ago
Feedback? Help us improve.