nano-manus

KO | EN

gitlite — search

#python #golang #go #machine-learning #rust #linux #windows #awesome #cli #security #mcp #ios #openai #open-source

(★ 54)

Implementing some features of Manus with MCP

File Explorer

Download Latest Version (.zip)

- - mock.csv
- - arch.png
  - nano-manus.mp4
- basic_planner.py
- load_mcp_tools.py
- - __init__.py
  - env.py
  - py.typed
- __init__.py
- test_basic.py
.gitignore
.python-version
pyproject.toml
README.md
uv.lock

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<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

## Use Cases

https://github.com/user-attachments/assets/33b90afc-2e30-4ab0-8988-bd7d6da065fb

- `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 use cases!

## QuickStart

#### Setup

- Install [NPM](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- Install [docker](https://docs.docker.com/engine/install/)

#### Env

- [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) Implementing [CodeAct](https://github.com/xingyaoww/code-act)
- [ ] (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.

nano-manus

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

nano-manus

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README