内容
<div align="center">
<img src="./src/assets/icon.png" alt="MTools Logo" width="128" height="128">
# MTools
一款功能强大、界面精美的现代化桌面工具集
[](https://www.python.org/)
[](https://flet.dev/)
[](./LICENSE)
[]()
[](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> — 提供稳定的云服务器资源，支持本项目运行
<br><br>
<a href="https://dmc.cc/">
<img src="./assets/dmc_logo.png" alt="DMC" height="48">
</a><br>
<b><a href="https://dmc.cc/">DMC dmc.cc</a></b> — 国产开源大模型 API，OpenAI 兼容，适用于字幕修复、AI 翻译等功能
</div>
---
## 📸 界面预览
<div align="center">
<table>
<tr>
<td align="center">
<img src="./assets/MTools_Light.png" alt="Light Mode" width="400">
<br><b>浅色主题</b>
</td>
<td align="center">
<img src="./assets/MTools_Dark.png" alt="Dark Mode" width="400">
<br><b>深色主题</b>
</td>
</tr>
</table>
</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.12
- **包管理器**: [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/)** - 提供稳定的云服务器资源
- **[DMC dmc.cc](https://dmc.cc/)** - 国产开源大模型 API，OpenAI 兼容
> AI 功能配置说明见 📘 **[AI API 服务商指南](./docs/ai_providers.md)**
---
<div align="center">
## Star History
[](https://star-history.dera.page/#HG-ha/MTools&type=Date)
---
## 支持项目
如果这个项目对你有帮助，欢迎通过以下方式支持：
- 给项目一个 ⭐ Star
- 分享给更多需要的人
- 提交 Issue 和 Pull Request
- 请作者喝杯咖啡 ☕
<details>
<summary>打赏支持</summary>
<br/>
你的支持是项目持续维护的动力！
<div align="center">
<img src="./assets/wechat_reward.jpg" alt="微信赞赏码" width="300"/>
<p><b>微信赞赏</b></p>
</div>
</details>
---
**Made with ❤️ using Python & Flet**
👨💻 **作者**：[HG-ha](https://github.com/HG-ha) · [加入Q群 1029212047](https://qm.qq.com/q/gHf7f0R3zy)
**如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！**
</div>
连接信息
猜你喜欢
暂无推荐服务器