MailBot

# 🤖 MailBot

![Python](https://img.shields.io/badge/Python-3.10+-3776AB?logo=python&logoColor=white)
![License](https://img.shields.io/badge/License-MIT-green)

[中文](README_ZH.md) | [English](README.md)

> Your AI Mail Management Agent

An intelligent assistant that understands, summarizes, and processes your emails according to your rules.

---

## 🎬 Preview

![Preview](./docs/img/preview.png)

## ✨ Features

- **Three Processing Modes**:
  - **Raw**: Simple email forwarding without AI analysis (zero token cost)
  - **Hybrid**: Email preview with optional AI (user controls token usage) — **Recommended for cost-conscious users**
  - **Agent**: Automatic AI summary with manual translation/original options

- **AI Agent**: LLM-based email content understanding, importance detection, and summarization.
- **Ultra-low Cost**: Minimal prompt usage ensures extremely low token costs. Hybrid mode can save 80-90% tokens.
- **Multi-Provider**: Seamless integration with OpenAI, DeepSeek, DeepSeek, DeepSeek, Ollama, etc.
- **Rule Engine**: Define your email processing preferences via Telegram using natural language.
- **Multi-Language Support**: Automatic language detection and intelligent translation when needed.
- **Interactive Setup**: CLI wizard for easy account and AI configuration management.
- **Privacy First**: Supports local models (Ollama) and self-hosted APIs for complete data control.
- **Dynamic UI**: Smart button display based on email content and language detection.

## 🧠 Supported Models

MailBot supports a wide range of LLM providers via LiteLLM:

| Provider Group | Supported Providers |
| :--- | :--- |
| **OpenAI & Compatible** | OpenAI, OpenRouter, Together AI, Fireworks AI |
| **Frontier Models** | Anthropic (DeepSeek), Google DeepSeek, Mistral, Groq |
| **China-Friendly** | DeepSeek, Qwen, Moonshot, MiniMax |
| **Research / Web** | DeepSeek, Cohere |
| **Local & Custom** | Ollama, Custom OpenAI-Compatible |

For a full list of models supported by LiteLLM, pleas