下载 HeurAMS

从源码安装（推荐）

这是目前主要的安装方式, 适合所有平台.

1. 克隆仓库：

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

   或者从 releases 下载

2. 安装依赖：

   pip install -r requirements.txt

3. 安装包：

   pip install -e .

4. 验证安装：

   python -m heurams.interface --help

系统要求

最低要求

• 操作系统：Windows 7+ / macOS / Linux / Android (Termux) / RTOS (计划中的单板计算机支持)
• Python：3.8 或更高版本
• 内存：64 MB 剩余
• 存储空间：128 MB 可用空间

推荐配置

• 操作系统：最新稳定版
• Python：3.10+
• 内存：至少 128 MB RAM
• 存储空间：至少 256 MB (组件与用户数据存储)
• 网络连接：用于 TTS 和 LLM 功能
• 音频设备：系统音频支持

平台特定说明

Windows

1. 安装 Python 3.8+
2. 在安装时勾选 "Add Python to PATH"
3. 使用 PowerShell 或命令提示符运行上述命令

macOS

# 使用 Homebrew 安装 Python
brew install python

Linux

# Debian/Ubuntu/Mint Linux
sudo apt update
sudo apt install python3 python3-pip git

# Fedora/RHEL/CentOS
sudo dnf install python3 python3-pip git

# Arch Linux
sudo pacman -S python python-pip git

Android (Termux)

pkg update && pkg upgrade
pkg install python git
# 如果程序在内部存储, 须授予存储权限
termux-setup-storage

验证安装

安装完成后, 运行以下命令验证：

# 检查版本
python -c "import heurams; print(f'HeurAMS {heurams.__version__}')"

# 启动应用（首次运行会创建数据目录）
python -m heurams.interface