Metadata-Version: 2.2
Name: mangopi-cli
Version: 0.1.11
Summary: Mango Pi Cli
Author: moofs
License: Apache License 2.0
Project-URL: Homepage, https://github.com/w4n9H/mangopi-cli
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# Mangopi CLI

> A lightweight AI coding assistant running directly in your terminal.

Mangopi CLI is a zero-dependency, local-first AI coding assistant inspired by Claude Code.

It supports:

* AI-powered coding workflows
* File editing and shell execution
* Tool calling
* Context-aware conversation management
* Automatic context compacting

All with instant startup and no heavy framework dependencies.

---

# Features

* Zero dependency (Python standard library only)
* Instant startup
* Claude Code–style terminal UX
* Built-in file and shell tools
* Automatic context compacting
* Local session persistence
* Fully hackable and easy to extend

---

# Installation

## From PyPI

```bash
pip install mangopi-cli
```

Start Mangopi CLI:

```bash
mangopi-cli
```

---

## From Source

```bash
git clone git@github.com:w4n9H/mangopi-cli.git
cd mangopi-cli
python mangopi_cli.py
```

---

# Configuration

Set your API configuration:

```bash
export MANGO_KEY="your_api_key"
export MANGO_API_URL="https://api.deepseek.com/chat/completions"
export MANGO_MODEL="deepseek-v4-flash"
```

Optional:

```bash
export MANGO_MAX_CONTEXT=1000000
export MANGO_LANG=zh
```

---

# Usage

Start the CLI:

```bash
mangopi-cli
```

or:

```bash
python mangopi_cli.py
```

Built-in commands:

| Command | Description     |
|---------|-----------------|
| `/q`    | Quit            |
| `/n`    | New session     |
| `/c`    | Compact session |
| `/h`    | Help            |

---

# Built-in Tools

* `read`
* `write`
* `edit`
* `search`
* `grep`
* `bash`

Mangopi CLI can autonomously inspect files, modify code, search projects, and execute shell commands.

---

# Philosophy

Mangopi CLI focuses on:

* fast startup
* zero dependency
* local-first workflows
* terminal-native AI interaction
* lightweight runtime design

No Electron, Docker, Redis, or heavyweight AI frameworks.

Just a fast and hackable AI coding assistant for the terminal.

---

# License

Apache License 2.0
