# xiaozhi-linux

**Repository Path**: aarch64/xiaozhi-linux

## Basic Information

- **Project Name**: xiaozhi-linux
- **Description**: linux AI小智！
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2026-01-29
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Linux 小智 AI 聊天机器人

项目主要参考虾哥 [ESP32 AI小智](https://github.com/78/xiaozhi-esp32 ) 项目设计，我们在嵌入式 Linux 平台进行完整支持，其中有幸联系到虾哥本人，非常感谢在调试中给予我们建议方向，我们才能以最短的时间支持完成。此仓库主要作为 Linux AI小智 核心代码部分，不含各个单板平台适配相关的硬件 BSP 驱动 以及依赖，如果需要支持某款单板请参考如下支持列表。

目前支持单板平台 NXP IMX6ULL 平台，在支持 全志Tina T113 V85x系列平台 ， 嘉楠K230 ，以及RK 系列 STM32MP157 等平台  。 未来计划支持更多平台芯片以及开发板,欢迎感兴趣同学 提交 支持。

已支持硬件列表：
- DshanPIxCanMV K230 Buildroot24系统 : [DshanPI-CanMV](https://github.com/100askTeam/xiaozhi-linux-SupportList/tree/DshanPI-CanMV)
- 100ASK_T113s3-PRO Tina4系统 :  [100ASK_T113s3-Pro_Tina4](https://github.com/100askTeam/xiaozhi-linux-SupportList/tree/100ASK_T113s3-Pro_Tina4)
- 100ASK_T113s3-PRO Tina5系统： [100ASK-T113s3-Pro_Tina5](https://github.com/100askTeam/xiaozhi-linux-SupportList/tree/100ask-T113s3-Pro_Tina5)
- DongshanPI-AICT Tina4系统 ： [DongshanPI-AICT](https://github.com/100askTeam/xiaozhi-linux-SupportList/tree/DongshanPI-AICT)
- 100ASK_IMX6ULL-PRO Buildroot20系统 : [100ASK_IMX6ULL-PRO](https://github.com/100askTeam/xiaozhi-linux-SupportList/tree/100ASK_IMX6ULL-PRO)

提交贡献更多单板请参考: https://github.com/100askTeam/xiaozhi-linux-SupportList 内 README 

Linux 小智运行演示视频：https://www.bilibili.com/video/BV17nXNYJE5P/?share_source=copy_web&vd_source=695e352380e69504d9d46eb5e7463838



## 1. 仓库介绍

源码主要结构：

![image-20250327113143486](docs/img/image-20250327113143486.png)



源码架构解析：

- 小智接口流程概述

![01_小智的接口流程概述](docs/img/01_小智的接口流程概述-1.png)

![01_小智的接口流程概述](docs/img/01_小智的接口流程概述-2.png)

![01_小智的接口流程概述](docs/img/01_小智的接口流程概述-3.png)

- sound_app框架分析

![02_sound_app框架分析](docs/img/02_sound_app框架分析-1.png)

![02_sound_app框架分析](docs/img/02_sound_app框架分析-2.png)

- control_center框架分析

![03_control_center框架分析](docs/img/03_control_center框架分析-1.png)

![03_control_center框架分析](docs/img/03_control_center框架分析-2.png)

![03_control_center框架分析](docs/img/03_control_center框架分析-3.png)



## 2. 编译方法

### 2.1 先编译库

进入libs目录，执行下面命令：

```shell
# 1. websocketpp在头文件里实现了功能，所以只需要下载
git clone https://github.com/zaphoyd/websocketpp.git

# 2. 交叉编译Boost
wget https://sourceforge.net/projects/boost/files/boost/1.85.0/boost_1_85_0.tar.gz
tar xzf boost_1_85_0.tar.gz
cd boost_1_85_0

# Configure for cross-compilation
echo "using gcc : arm : arm-buildroot-linux-gnueabihf-g++ ;" > user-config.jam
./bootstrap.sh
./b2 --user-config=user-config.jam     toolset=gcc-arm     --prefix=$PWD/tmp     install
```



### 2.2 再编译APP

编译sound_app：

```shell
cd sound_app
make
# 在sound_app目录下生成了sound_app
```

编译control_center：

```shell
cd control_center
make
# 在control_center目录下生成了control_center
```



最后编译GUI：

```shell
cd gui
chmod +x ./build.sh
./build.sh
# 在gui/bin目录下生成了lvgl_xiaozhi
```



## 3. 在IMX6ULL上运行程序

### 3.1 复制库

```shell
# 把Ubutnu上编译的bootst库libs/boost_1_85_0/tmp/lib/*放到板子的/usr/lib目录
```

### 3.2 复制字库、图片等

```shell
# 把GIT仓库里pre-build/usr/share/xiaozhi 
# 放到单板/usr/share目录
# 得到/usr/share/xiaozhi
```

### 3.3 关闭原来的GUI

```shell
mv  /etc/init.d/*hmi*  /root
mv  /etc/init.d/*lvgl*  /root    // 不一定有这个文件，没关系
reboot

# 如果要恢复原来的GUI执行下面命令
mv  /root/*hmi*  /etc/init.d
mv  /root/*lvgl*  /etc/init.d
reboot
```



### 3.4 运行程序

把这3个编译出来的程序放到单板上，执行：

```shell
./lvgl_xiaozhi &    
./control_center &
./sound_app &
```





## 4. 提交贡献

此仓库目前只是保留 Linux AI小智部分源码，不含平台相关，欢迎大家 提交 issue PR 来帮助改进 Linux小智。



## 5. 交流学习

QQ交流群：564992486 

AIOT边缘AI大模型开发课程：https://item.taobao.com/item.htm?id=901161273967