安装指南

本文介绍 HeurAMS 在不同平台上的安装方法.

系统要求

• 操作系统：Windows 10+ / macOS 10.15+ / Linux (主流发行版) / Android (需 Termux)
• Python 版本：3.8 或更高
• 磁盘空间：至少 100 MB 可用空间
• 网络连接：用于下载依赖、语音缓存和 LLM 服务（可选）

安装方法

方法一：从源码安装（推荐）

1. 克隆仓库：

   git clone https://gitea.imwangzhiyu.xyz/ajax/HeurAMS
   cd HeurAMS

2. 安装依赖：

   pip install -r requirements.txt

3. 以开发模式安装包：

   pip install -e .

4. 验证安装：

   python -m heurams.interface --help

方法二：使用 pip 安装（开发中）

注意：HeurAMS 尚未发布到 PyPI, 此方法暂不可用.

方法三：预编译包（计划中）

未来将提供各平台的独立可执行文件, 无需 Python 环境.

平台特定说明

Windows

1. 安装 Python 3.8+ 从 python.org
2. 确保将 Python 添加到 PATH
3. 在 PowerShell 或命令提示符中运行上述命令

macOS

1. 使用 Homebrew 安装 Python：

   brew install python

2. 或从 python.org 下载安装器
3. 可能需要安装系统音频依赖（通常已内置）

Linux

大多数发行版已预装 Python 3. 确保安装 pip：

sudo apt install python3-pip  # Debian/Ubuntu
sudo dnf install python3-pip  # Fedora
sudo pacman -S python-pip     # Arch

Android (Termux)

1. 安装 Termux 从 F-Droid
2. 更新并安装 Python：

   pkg update && pkg upgrade
   pkg install python
   pip install -r requirements.txt

3. 注意：某些音频功能可能需要额外配置

依赖项说明

主要依赖包：

• textual：终端用户界面框架
• toml：配置文件解析
• playsound / simpleaudio：音频播放
• edge-tts：微软 TTS 服务
• openai / litellm：LLM 集成（可选）

完整列表见 requirements.txt.

常见安装问题

1. "ModuleNotFoundError: No module named '...'"

确保已安装所有依赖：

pip install -r requirements.txt

2. 音频播放失败

• Windows：确保系统音频服务正常
• Linux：安装 alsa-utils 或 pulseaudio
• macOS：通常无需额外配置

3. TTS 服务连接超时

检查网络连接, 或使用离线 TTS 选项（若已实现）.

4. 内存/磁盘空间不足

清理缓存或扩展存储空间.

下一步

安装完成后, 请继续阅读快速入门开始使用 HeurAMS.