发帖
3 0 0

【AiPi-PalChatV1】Ubuntu系统 二开环境搭建

WT_0213
论坛元老

119

主题

1698

回帖

1万

积分

论坛元老

勤劳的打工人

积分
15709
小安AI 51 3 昨天 11:09
[i=s] 本帖最后由 WT_0213 于 2025-7-14 15:17 编辑 [/i]

由于电脑安装wsl失败了,所以装了个双系统。下面介绍下在linux环境下搭建AiPi-PalChatV1二开环境。

安装MiniConda

这一步不是必须的,但是建议安装。后续开发MCP的时候能用上。

Anaconda 官网
https://www.anaconda.com/

截图2025-07-1410-32-18.png

点击 Free Download

跳转

Snipaste_2025-07-14_10-58-20.png
跳过注册直接下载

Snipaste_2025-07-14_10-59-20.png
点击即可下载。

或者直接下载:

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

截图2025-07-0917-15-57.png

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

source ~/.bashrc

验证

conda

截图2025-07-0917-16-55.png

然后创建个虚拟环境,用来为后续开发作准备

conda create -n aipi

截图2025-07-0917-17-51.png

conda activate aipi
安装二开环境
sudo apt-get install git gcc make python3 python3-pip python3-numpy ffmpeg libopus0 libopus-dev

克隆项目源代码

截图2025-07-0917-19-01.png

由于没有git需要安装,根据提示完成git的安装

sudo apt install git

完成源代码克隆

截图2025-07-0917-19-20.png

运行安装脚本

截图2025-07-0917-19-35.png

编译,发现没有make工具

截图2025-07-0917-19-56.png

安装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更多属于进阶选择。 ‌

这里用的第一个。

截图2025-07-0917-20-10.png
安装完成后编译源码

截图2025-07-0917-20-26.png

编译成功

截图2025-07-0917-21-13.png

总体来说很顺利,一把过。

这样做的缺点就是不能直接用官方提供的烧录工具进行烧录。
虽然安装了wine

sudo apt install wine

运行起来了烧录工具,但是 串口设备找不到。到这里环境搭建完成。
目前源码未对个人开发者全部开放,可以定制的功能比较有限。文档相对来说不是很全面。希望后期大佬有空闲时间时可以逐步完善一下文档。


烧录工具可以从博流开发者社区下载,地址为:
https://dev.bouffalolab.com/download

Snipaste_2025-07-14_14-57-10.png

下载后解压内容为

Snipaste_2025-07-14_14-57-56.png

cd BouffaloLabDevCube-v1.9.0/
chmod +x BLDevCube-ubuntu
./BLDevCube-ubuntu

如果报错无法启动,提示 settting相关错误,尝试执行以下命令

sudo nano /etc/gdm3/custom.conf

Snipaste_2025-07-14_15-01-30.png

解除注释,重启服务

sudo systemctl restart gdm3

然后会注销,重新输入密码登录系统后,再次执行

./BLDevCube-ubuntu

Snipaste_2025-07-14_15-04-39.png
可以看到烧录工具已经启动了。

Snipaste_2025-07-14_15-05-13.png

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

Snipaste_2025-07-14_15-05-34.png

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

Snipaste_2025-07-14_15-13-32.png

少了一些支持的平台,博流下载的是全平台的。不过开发的话可能还是Windows下比较舒服。

感谢 hdydy ,不然在linux下开发烧录很麻烦。

──── 0人觉得很赞 ────

使用道具 举报

BouffaloLabDevCube里面有Ubuntu环境中的烧录工具
image.png

另外,不能在Windows中开发吗

昨天 13:55
hdydy 发表于 2025-7-14 12:38
BouffaloLabDevCube里面有Ubuntu环境中的烧录工具

另外,不能在Windows中开发吗

哦?我的里面好像没有这两个文件。我看看下载官方的工具试试。
昨天 22:05
感谢幸福哥的分享~
您需要登录后才可以回帖 立即登录
高级模式
返回
统计信息
  • 会员数: 29253 个
  • 话题数: 42201 篇