[i=s] 本帖最后由 WT_0213 于 2025-7-14 15:17 编辑 [/i]
由于电脑安装wsl失败了,所以装了个双系统。下面介绍下在linux环境下搭建AiPi-PalChatV1二开环境。
安装MiniConda
这一步不是必须的,但是建议安装。后续开发MCP的时候能用上。
Anaconda 官网
https://www.anaconda.com/

点击 Free Download
跳转

跳过注册直接下载

点击即可下载。
或者直接下载:
https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
权限、安装
chmod 777 Miniconda3-latest-Linux-x86_64.sh
./Miniconda3-latest-Linux-x86_64.sh

安装完成后,运行conda命令会提示为找到。因为还没生效,通过source 命令使其生效。
source ~/.bashrc
验证
conda

然后创建个虚拟环境,用来为后续开发作准备
conda create -n aipi

conda activate aipi
安装二开环境
sudo apt-get install git gcc make python3 python3-pip python3-numpy ffmpeg libopus0 libopus-dev
克隆项目源代码

由于没有git需要安装,根据提示完成git的安装
sudo apt install git
完成源代码克隆

运行安装脚本

编译,发现没有make工具

安装make,提示两个安装指令
sudo apt install make
或者
sudo apt install make-guile
搜了一下区别
make是Linux系统中的自动化构建工具,用于根据Makefile文件自动编译和构建项目;而make-guile是make的一个版本,内置了Guile Scheme解释器,允许在Makefile中使用Scheme语言进行更灵活的脚本扩展和配置。
核心差异
功能定位:make是通用构建工具,负责编译源代码、链接生成可执行文件等基础功能;make-guile通过内置Scheme解释器,扩展了Makefile的编程能力,支持更复杂的自动化流程定义。
使用场景:普通项目开发中,make通过标准Makefile即可完成编译需求;当需要自定义复杂编译逻辑(如多平台适配、动态依赖管理等)时,make-guile提供的Scheme扩展性更适用。
安装方式
两者均通过Ubuntu包管理器安装:
sudo apt install make
sudo apt install make-guile
但实际开发中,直接安装make即可满足大部分需求,make-guile更多属于进阶选择。
这里用的第一个。

安装完成后编译源码

编译成功

总体来说很顺利,一把过。
这样做的缺点就是不能直接用官方提供的烧录工具进行烧录。
虽然安装了wine
sudo apt install wine
运行起来了烧录工具,但是 串口设备找不到。到这里环境搭建完成。
目前源码未对个人开发者全部开放,可以定制的功能比较有限。文档相对来说不是很全面。希望后期大佬有空闲时间时可以逐步完善一下文档。
烧录工具可以从博流开发者社区下载,地址为:
https://dev.bouffalolab.com/download

下载后解压内容为

cd BouffaloLabDevCube-v1.9.0/
chmod +x BLDevCube-ubuntu
./BLDevCube-ubuntu
如果报错无法启动,提示 settting相关错误,尝试执行以下命令
sudo nano /etc/gdm3/custom.conf

解除注释,重启服务
sudo systemctl restart gdm3
然后会注销,重新输入密码登录系统后,再次执行
./BLDevCube-ubuntu

可以看到烧录工具已经启动了。

页面基本相同,一般外置的串口设备,可能是ttyUSBx
例如:

小安AI 使用指南中提供的烧录工具与博流提供的工具对比

少了一些支持的平台,博流下载的是全平台的。不过开发的话可能还是Windows下比较舒服。
感谢 hdydy ,不然在linux下开发烧录很麻烦。