新手必看：SUSI.AI安装前的系统环境准备清单
【免费下载链接】susi_installerSUSI Installer for RPi and Linux Desktops项目地址: https://gitcode.com/gh_mirrors/su/susi_installer
SUSI.AI是一款开源的智能语音助手，可在树莓派（RPi）和Linux桌面系统上运行。为确保安装过程顺利进行，本指南将详细介绍安装前需要准备的系统环境和依赖项，帮助新手用户快速完成前期配置。
一、硬件要求
SUSI.AI对硬件配置要求不高，但建议满足以下基本条件：
- 树莓派：Raspberry Pi 3B及以上型号（推荐4B以获得更好性能）
- 存储：至少8GB microSD卡（建议Class 10高速卡）
- 网络：稳定的WiFi连接或以太网接口
- 音频设备：麦克风（用于语音输入）和扬声器（用于语音输出）
二、操作系统支持
SUSI.AI支持以下操作系统：
- 树莓派：Raspbian Buster及以上版本
- Linux桌面：Ubuntu 18.04+/Mint 19.2+/Fedora 31+/openSUSE Leap 15.1+/Arch Linux
三、必装系统依赖项
3.1 核心工具安装
以下工具是SUSI.AI运行的基础，需通过系统包管理器安装：
| 程序 | Debian/Ubuntu/Mint | Fedora | openSUSE Leap | Arch Linux |
|---|---|---|---|---|
| git | sudo apt install git | sudo dnf install git | sudo zypper install git | sudo pacman -S git |
| wget | sudo apt install wget | sudo dnf install wget | sudo zypper install wget | sudo pacman -S wget |
| curl | sudo apt install curl | sudo dnf install curl | sudo zypper install curl | sudo pacman -S curl |
| python3 | sudo apt install python3 | sudo dnf install python3 | sudo zypper install python3 | sudo pacman -S python3 |
| pip3 | sudo apt install python3-pip | sudo dnf install python3-pip | sudo zypper install python3-pip | sudo pacman -S python3-pip |
3.2 音频与媒体依赖
SUSI.AI需要音频处理工具和媒体播放器支持：
| 程序 | Debian/Ubuntu/Mint | Fedora | 备注 |
|---|---|---|---|
| sox | sudo apt install sox | sudo dnf install sox | 音频处理工具 |
| vlc | sudo apt install vlc-bin | sudo dnf install vlc | 需先启用RPMFusion仓库 |
| flac | sudo apt install flac | sudo dnf install flac | 音频编码支持 |
图：在Raspbian系统中通过"Preferences > Audio Device Settings"配置音频设备
3.3 网络与开发工具
为支持远程管理和开发功能，需安装：
# 安装SSH服务（树莓派） sudo apt install openssh-server # 安装Java运行时（部分服务依赖） sudo apt install default-jre-headless图：在树莓派配置工具中启用SSH服务，便于远程管理
四、WiFi网络配置（树莓派）
若使用WiFi连接，需提前配置网络：
编辑WiFi配置文件：
sudo nano /etc/wpa_supplicant/wpa_supplicant.conf添加网络信息：
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 network={ ssid="YOUR_SSID" psk="YOUR_PASSWORD" }
图：WiFi配置文件示例，需替换YOUR_SSID和YOUR_PASSWORD为实际网络信息
五、Python依赖自动安装
项目提供了自动安装脚本，可一键安装所需Python库：
克隆项目仓库：
git clone https://gitcode.com/gh_mirrors/su/susi_installer cd susi_installer运行依赖安装脚本：
# 基础依赖安装 ./install-requirements.sh # 如需系统级安装（推荐） ./install-requirements.sh --system-install
核心Python依赖来自以下文件：
- 基础依赖：requirements.txt
- 可选依赖：requirements-optional.txt
六、系统环境验证
安装完成后，可通过以下命令验证关键依赖是否就绪：
# 检查Python版本 python3 --version # 检查pip版本（需≥19.0） pip3 --version # 检查网络连接 ping -c 3 susi.ai七、常见问题解决
7.1 Fedora系统VLC安装
Fedora需先启用RPMFusion仓库：
sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm sudo dnf install vlc7.2 音频设备检测
若音频设备无法识别，可运行：
# 列出音频设备 arecord -l # 麦克风 aplay -l # 扬声器八、准备就绪
完成以上步骤后，您的系统已具备安装SUSI.AI的所有条件。接下来可执行主安装脚本：
./install-susi.sh详细安装指南可参考项目文档：docs/raspberry-pi_install.md（树莓派）或docs/ubuntu_install.md（Ubuntu桌面）。
祝安装顺利！如有问题，可查阅项目TODO文档或社区支持资源。
【免费下载链接】susi_installerSUSI Installer for RPi and Linux Desktops项目地址: https://gitcode.com/gh_mirrors/su/susi_installer
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
