1176 字

6 分钟

卸载 miniaiapi 项目完整指南

2025-04-17

2026-01-17

AI实验室

AI开发

环境清理

miniaiapi

要彻底卸载 easychen/miniaiapi 项目并尽可能恢复到安装前的状态，你需要执行以下步骤。由于这个项目涉及到了 Node.js、Python 及其相关的 M series Mac 优化工具，卸载过程会比普通的软件卸载复杂一些。

重要提示： 在执行任何删除操作之前，请务必备份任何重要数据或配置文件。

第一步：停止并关闭 `MiniAiApi` 服务#

如果 MiniAiApi 正在运行，你需要先停止它。

查找并停止 Node.js 进程： 如果你是使用 npm start 或 npm run dev 启动的，可以在终端中使用 Ctrl + C 停止。如果服务在后台运行，你需要找到其进程ID并终止它。
- 查找 Node.js 进程：
  Terminal window
```
1
ps aux | grep node
```
- 找到与 miniaiapi 相关的进程 ID (PID)，然后终止它：
  Terminal window
```
1
kill <PID>
```

第二步：清理 `MiniAiApi` 项目文件#

删除 miniaiapi 项目的整个目录。

进入项目根目录：

1
cd <miniaiapi_project_directory> # 替换为你的项目路径

删除项目文件夹：
Terminal window
```
1
rm -rf .
2
cd ..
3
rm -rf miniaiapi
```

第三步：卸载 Node.js 依赖#

MiniAiApi 项目使用 npm 安装了 Node.js 依赖。虽然删除了项目文件夹，但如果全局安装了某些包，或者 npm 缓存仍在，最好也清理一下。

清除 npm 缓存：
Terminal window
```
1
npm cache clean --force
```

第四步：卸载 Python 相关的依赖和工具#

MiniAiApi 项目依赖于 M-series Mac 上的 Python 生态系统，包括 MLX Whisper、MLX-Audio、FFmpeg 以及可选的 LMstudio 和 Draw Things。卸载这些是恢复环境的关键步骤。

4.1 卸载 Python `pip` 包#

MLX Whisper 和 MLX-Audio 是通过 pip 安装的。

卸载 mlx-whisper 和 mlx-audio：
Terminal window
```
1
# 安装自动移除依赖工具
2
pip install pip-autoremove
3
# 卸载特定包包含依赖
4
pip-autoremove mlx-whisper mlx-audio huggingface_hub
```
如果提示不再使用了，可以跳过。如果还有其他通过 pip 为该项目安装的包，也可以一并卸载。你可以使用 pip list docs.pingcode.com 查看当前安装的包。
清除 pip 缓存： docs.pingcode.com
Terminal window
```
1
pip cache purge
```

4.2 卸载 Conda/Miniconda (如果使用)#

如果你的 Python 环境是通过 Anaconda 或 Miniconda 管理的，并且你为这个项目创建了特定的环境，你应该移除该环境。如果 miniaiapi 建议使用 Conda，可能你安装了。

查找并删除 miniaiapi 相关的 Conda 环境： 首先列出所有 Conda 环境：
Terminal window
```
1
conda env list
```
如果你为 miniaiapi 创建了特定的环境（例如 miniaiapi-env），则删除它：
Terminal window
```
1
conda remove -n miniaiapi-env --all
```
清理 Conda 缓存： docs.pingcode.com
Terminal window
```
1
conda clean --all
```
删除 Miniconda/Anaconda (如果仅为 miniaiapi 项目安装)： 如果你想要彻底移除 Miniconda 或 Anaconda，可以参考以下步骤：
- 删除安装目录：
  Terminal window
```
1
rm -rf ~/miniconda3 # 或者你的安装路径
```
- 移除 ~/.bashrc 或 ~/.zshrc 中的相关环境变量配置（conda initialize 块）。你可以用 vim 或其他文本编辑器打开文件，把相关行注释掉或删除 jianshu.com。
- 刷新 shell 配置：
  Terminal window
```
1
source ~/.bashrc # 或 source ~/.zshrc
```

4.3 移除 MLX 模型文件#

MiniAiApi 建议预下载 MLX 模型。这些模型通常存储在 Hugging Face 的缓存目录中。

查找 Hugging Face 缓存目录： 通常在 ~/.cache/huggingface/hub/。
删除 miniaiapi 相关的模型文件： 你可以手动进入该目录，删除 mlx-community/whisper-large-v3-mlx、mlx-community/Spark-TTS-0.5B-fp16 等模型对应的文件夹。请谨慎操作，确保只删除与 miniaiapi 相关的模型，以免影响其他依赖 Hugging Face 模型的应用。

4.4 卸载 FFmpeg#

FFmpeg 是通过 Homebrew 安装的。

卸载 FFmpeg：
Terminal window
```
1
brew uninstall ffmpeg
```

第五步：卸载第三方应用 (LMstudio, Draw Things)#

MiniAiApi 项目集成了 LMstudio 和 Draw Things，如果这些应用是专门为 MiniAiApi 安装的，你也可以选择卸载它们。

卸载 LMstudio：
- 将 LMstudio 应用程序拖到废纸篓。
- 查看 ~/Library/Application Support/、~/Library/Preferences/ 等目录，删除与 LMStudio 相关的残留文件。
卸载 Draw Things：
- Draw Things 通常从 App Store 安装。可以在“启动台”或“应用程序”文件夹中找到它，将其拖到废纸篓。
- 类似 LMstudio，检查 ~/Library/ 下的目录，删除相关残留。

第六步：清理环境变量和配置文件#

MiniAiApi 在 .env 文件中配置了许多环境变量。虽然删除了项目目录，但如果这些配置曾被复制到全局环境变量中，你也需要清理。

检查并清理 shell 配置文件： 检查 ~/.bashrc, ~/.zshrc, ~/.bash_profile, ~/.profile 等文件，查找并删除任何与 MiniAiApi 项目相关的 PATH 变量或其他环境变量配置。

第七步：重启系统 (可选但推荐)#

重启电脑可以确保所有进程都已终止，并且所有环境变更都已生效。

通过以上详细步骤，你应该能够彻底卸载 easychen/miniaiapi 项目及其绝大部分相关依赖，将系统尽可能恢复到安装前的状态。

支持与分享

如果这篇文章对你有帮助，欢迎分享给更多人或赞助支持！

赞助

卸载 miniaiapi 项目完整指南

https://blog.moewah.com/posts/uninstall-miniaiapi-project-complete-guide/

作者

GoWah

发布于

2025-04-17

许可协议

CC BY-NC-SA 4.0

从断供到自救：如何备份MinIO多架构Docker镜像

Astro构建失败？7个原因5分钟搞定

卸载 miniaiapi 项目完整指南

第一步：停止并关闭 MiniAiApi 服务#

第二步：清理 MiniAiApi 项目文件#

第三步：卸载 Node.js 依赖#

第四步：卸载 Python 相关的依赖和工具#

4.1 卸载 Python pip 包#

4.2 卸载 Conda/Miniconda (如果使用)#

4.3 移除 MLX 模型文件#

4.4 卸载 FFmpeg#

第五步：卸载第三方应用 (LMstudio, Draw Things)#

第六步：清理环境变量和配置文件#

第七步：重启系统 (可选但推荐)#

推荐文章

支持与分享

目录

第一步：停止并关闭 `MiniAiApi` 服务#

第二步：清理 `MiniAiApi` 项目文件#

4.1 卸载 Python `pip` 包#