Metadata-Version: 2.4
Name: nano_manus
Version: 0.0.3
Summary: Implementing some features of Manus with MCP
Author-email: Gus <contact@memobase.io>
Requires-Python: >=3.11
Requires-Dist: mcp>=1.3.0
Requires-Dist: openai>=1.65.4
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: rich>=13.9.4
Description-Content-Type: text/markdown

<div align="center">
  <h1>🐜 nano_manus</h1>
  <p><strong>Implementing some features of Manus with MCP</strong></p>
  <p>
    <a href="https://pypi.org/project/nano_manus/" > 
    	<img src="https://img.shields.io/badge/python->=3.11-blue">
    </a>
    <a href="https://pypi.org/project/nano_manus/">
      <img src="https://img.shields.io/pypi/v/nano_manus.svg">
    </a>
  </p>
</div>


<div align="center">
    <picture>
      <img alt="Shows the Memobase Workflow" src="./examples/imgs/arch.png" width="80%">
    </picture>
  <p>nano-manus</p>
</div>



## Features

- **Small**: `nano_manus` is about 1000 LOC.
- **Using MCP**: `nano_manus` supports [loading MCP](./examples/load_mcp_tools.py) from [docker](https://hub.docker.com/u/mcp), `npx` and [Smithery](https://smithery.ai/)
- **Plan-then-Execute**: `nano_manus` will gather your agents, make the plans and then assign the correct jobs to your agents



## User Cases

<div align="center">
		  <video width="80%" controls>
            <source src="./examples/imgs/nano-manus.mp4" type="video/mp4">
        </video>
  <p>nano-manus demo video</p>
</div>

- `Find all .py file and explain them to me `
- `Give me the latest weather in SF in last 7 days and save it to csv`

> Welcome to give more user cases!



## QuickStart

#### Setup

- [Brave Search API key](https://brave.com/search/api/)
- [Jina API key](https://jina.ai/)
- OpenAI API key

Your `.env` should look like:

```
BRAVE_API_KEY=BSAxxxx
JINA_API_KEY=jina_xxxx
OPENAI_API_KEY=sk-proj-XXXXX
```

#### Run default `nano-manus`

```bash
uv sync
uv run examples/basic_planner.py
```



## Abilities

- [x] Search Web (`mcp/brave-search`, `jina-ai-mcp-server`)
- [x] Local files operations (`@wonderwhy-er/desktop-commander`)
- [x] Execute codes and commands in your computer (`@wonderwhy-er/desktop-commander`)
- [ ] (coming soon) Read `.pdf, .doc`
- [ ] (coming soon) browser use
- [ ] (coming soon) multi-model router (`claude`, `qwen`, `deepseek`...)





## Known Issues

- `nano-manus` is extremely unstable! My guess is `gpt-4o` is not that good at tool use.
- `Unable to exit`: seem like some MCPs will cause the problems of unable to exit the program when all the tasks were done.
- `nano-manus` will operate files and run command **on the current dir of your local computer**, make sure you don't run it on some important folders.
