KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

MTools

★ 1,283 Open GitHub ↗

MTools 是一个功能强大的多功能桌面应用程序，集成了音视频处理、图片编辑、文本操作和编码工具，内置AI增强功能。旨在简化您的工作流程，提升生产效率

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MTools
一款功能强大、界面精美的现代化桌面工具集

[![Python](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/)
[![Flet](https://img.shields.io/badge/Flet-0.84.0-brightgreen.svg)](https://flet.dev/)
[![License](https://img.shields.io/badge/License-MIT-orange.svg)](https://raw.githubusercontent.com/HG-ha/MTools/main/LICENSE)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)]()
[![Downloads](https://img.shields.io/github/downloads/HG-ha/MTools/total?style=flat-square)](https://github.com/HG-ha/MTools/releases)

集成图片处理、音视频编辑、AI 智能工具、开发辅助等功能，支持跨平台GPU加速

---

## 🤝 合作伙伴

<div align="center">
<a href="https://www.atlascloud.ai/">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./assets/atlas_cloud_logo_white.svg">
<source media="(prefers-color-scheme: light)" srcset="./assets/atlas_cloud_logo.svg">
<img src="./assets/atlas_cloud_logo.svg" alt="Atlas Cloud" width="180">
</picture>
</a><br>
<b><a href="https://www.atlascloud.ai/">Atlas Cloud</a></b> — 一个 API 接入 300+ 大模型，OpenAI 兼容，适用于字幕修复、AI 翻译等功能<br>
Base URL：<code>https://api.atlascloud.ai/v1</code> · <a href="./docs/ai_providers.md">配置说明</a>
<br><br>
<a href="https://www.dkdun.cn/">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./assets/dkdun_logo_white.png">
<source media="(prefers-color-scheme: light)" srcset="./assets/dkdun_logo.png">
<img src="./assets/dkdun_logo.png" alt="林枫云" height="36">
</picture>
</a><br>
<b><a href="https://www.dkdun.cn/">林枫云 www.dkdun.cn</a></b> — 提供稳定的云服务器资源，支持本项目运行
</div>

---

## 📸 界面预览

</div>

---

## 快速开始

### 方式一：下载发布版（推荐）

直接下载已编译好的可执行文件，**无需安装 Python**：

- **[Releases 下载](https://github.com/HG-ha/MTools/releases)**
- **[国内用户下载](https://openlist.wer.plus/MTools)**

支持平台及预编译版本说明：
- ✅ Windows 10/11 (x64)
  - MTools_Windows_amd64：体积最小，并且支持nvidia、amd、intel显卡加速，但不支持手动管理显存，如果您的显存低于8GB或发布时间早于nvidia30系，尽量使用此版本
  - MTools_Windows_amd64_CUDA：体积中等，使用CUDA进行加速，但需要手动安装CUDA 12.x + cuDNN 9.x
  - MTools_Windows_amd64_CUDA_FULL：体积最大，内置完整的CUDA加速环境，无需手动安装CUDA和cuDNN

- ✅ macOS (实验性支持)
  - MTools_Darwin_arm64：只支M系列芯片，支持Core ML加速

- ✅ Linux (实验性支持)
  - MTools_Linux_amd64：体积最小，不支持GPU加速
  - MTools_Linux_amd64_CUDA：体积中等，使用CUDA进行加速，但需要手动安装CUDA 12.x + cuDNN 9.x
  - MTools_Linux_amd64_CUDA_FULL：体积最大，内置完整的CUDA加速环境，无需手动安装CUDA和cuDNN

下载后解压即可使用！

### 方式二：从源码运行

#### 环境要求
- **操作系统**: Windows 10/11、macOS 或 Linux
- **Python**: 3.11+
- **包管理器**: [uv](https://github.com/astral-sh/uv) - 推荐使用的 Python 包管理器

#### 一键安装依赖

```bash
# 1. 克隆仓库
git clone https://github.com/HG-ha/MTools.git
cd MTools

# 2. 一键同步依赖（自动创建虚拟环境）
uv sync

# 3. 运行程序
uv run flet run
```

启用 CUDA GPU 加速（默认已启用平台通用加速）：

```bash
# 使用此方式可完全榨干NVIDIA GPU性能
# 替换为 GPU 版本（需要 NVIDIA GPU 和 CUDA 环境）
uv remove onnxruntime-directml onnxruntime
uv add onnxruntime-gpu==1.24.4
# 需要免去配置cuda和cudnn环境的话请更改为此依赖
# 会导致体积增大数倍
# uv add onnxruntime-gpu[cuda,cudnn]==1.24.4
```

> 📘 **版本说明**：
> - **普通版本**：支持NVIDIA、AMD、Intel显卡加速，支持coreml加速，对 NVIDIA GPU 的性能释放可能不如CUDA系列
> - **CUDA 版本**：使用系统安装的 CUDA 和 cuDNN，体积小但需要预先配置 CUDA 环境（CUDA 12.x + cuDNN 9.x）
> - **CUDA_FULL 版本**：内置完整的 CUDA 和 cuDNN 运行时库，无需额外配置，开箱即用，但体积较大（+2GB）

> 💡 **编译和版本说明**：如需将项目编译为独立可执行文件，请参考 📘 **[完整编译指南](./docs/build_guide.md)**

---

## MCP / Agent 接入

MTools 内置 **Streamable HTTP MCP**，可在应用内开启后供 OpenClaw、Hermes、Cursor 等调用本地工具能力。

1. 打开 MTools → **设置 → MCP 服务** → 启用  
2. 默认地址：`http://127.0.0.1:8765/mcp`  
3. 将仓库内 Skill 安装到 Agent：[`skills/mtools/`](./skills/mtools/)  
4. 配置片段与说明见 [`skills/mtools/install.md`](./skills/mtools/install.md) 与 [`docs/mcp.md`](./docs/mcp.md)

语音识别已通过 **sherpa-onnx** 集成 SenseVoice / Paraformer（完全本地，无需 `funasr` Python 包）。

---

## 性能优化

### GPU 加速支持

本项目的 AI 功能支持 GPU 加速，可大幅提升处理速度，并且提供 `CUDA` 以及 `CUDA_FULL` 编译版本

### 平台特定说明

#### AI 功能（ONNX Runtime）

| 平台 | 默认版本 | GPU 支持 | 说明 |
|------|---------|---------|------|
| **Windows** | `onnxruntime-directml==1.24.4` | ✅ DirectML | 自动支持 Intel/AMD/NVIDIA GPU |
| **macOS (Apple Silicon)** | `onnxruntime==1.24.4` | ✅ CoreML | 内置硬件加速 |
| **macOS (Intel)** | `onnxruntime==1.24.4` | ⚠️ CPU | 无 GPU 加速 |
| **Linux** | `onnxruntime==1.24.4` | ⚠️ CPU | 可选 `onnxruntime-gpu` (CUDA) |

> 💡 **提示**：DirectML 版本不支持限制显存，只有CUDA可限制显存大小

---

## 致谢

### 代码参考

本项目在开发过程中参考和使用了以下开源项目的代码：

- **[sherpa-onnx](https://github.com/k2-fsa/sherpa-onnx)** - 语音识别与合成框架，提供高性能的离线语音处理能力
- **[PPOCR_v5](https://github.com/Nnow2024/PPOCR_v5)** - 高精度OCR识别引擎
- **[FunASR](https://github.com/modelscope/FunASR)** - 语音识别工具包
- **[ICP_Query](https://github.com/HG-ha/ICP_Query)** - ICP备案查询功能实现
- **[HivisionIDPhotos](https://github.com/Zeyi-Lin/HivisionIDPhotos)** - AI证件照
- **[video-subtitle-remover](https://github.com/YaoFANGUK/video-subtitle-remover)** - AI去水印

### 外部服务

本项目使用了以下外部服务：

- **[ModelScope](https://www.modelscope.cn/)** - AI模型托管与分享平台
- **[imagetourl.net](https://imagetourl.net/)** - 图片转URL服务
- **[catbox.moe](https://catbox.moe/)** - 文件上传服务
- **[gh-proxy.com](https://gh-proxy.com/)** - GitHub加速代理

### 合作伙伴 / 赞助

感谢以下合作伙伴对本项目的支持：

- **[Atlas Cloud](https://www.atlascloud.ai/)** - 提供 AI API 赞助支持，OpenAI 兼容的多模态推理平台，一个 API 接入 300+ 模型
- **[林枫云 www.dkdun.cn](https://www.dkdun.cn/)** - 提供稳定的云服务器资源

> AI 功能配置说明见 📘 **[AI API 服务商指南](./docs/ai_providers.md)**

---

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=HG-ha/MTools&type=Date)](https://star-history.com/#HG-ha/MTools&Date)

---

## 支持项目

如果这个项目对你有帮助，欢迎通过以下方式支持：

- 给项目一个 ⭐ Star
- 分享给更多需要的人
- 提交 Issue 和 Pull Request
- 请作者喝杯咖啡 ☕

<br/>

你的支持是项目持续维护的动力！

</details>

---

**Made with ❤️ using Python & Flet**

👨‍💻 **作者**：[HG-ha](https://github.com/HG-ha) · [加入Q群 1029212047](https://qm.qq.com/q/gHf7f0R3zy)

**如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！**

</div>

MTools

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README