# voice-assistant

**Repository Path**: hellolutar/voice-assistant

## Basic Information

- **Project Name**: voice-assistant
- **Description**: 语音助手
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



**ai环境搭建**

``` shell

mkdir ai-model demo

sudo apt install python3-venv
python3 -m venv .venv
source .venv/bin/activate

sudo apt update && sudo apt install -y pciutils lshw zstd
pip install -U modelscope

# 如果以下命令提示报错 "ModuleNotFoundError: No module named 'pkg_resources'"
# 则需要降级setuptools, 原因是：setuptools 82.0.0 版本正式移除了 pkg_resources模块。
# python -m pip install setuptools==77.0.3
modelscope download --model Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice --local_dir ai-model/Qwen3-TTS-12Hz-1.7B-CustomVoice
modelscope download --model Qwen/Qwen3-ASR-1.7B  --local_dir ai-model/Qwen3-ASR-1.7B

git clone --depth=1 https://github.com/QwenLM/Qwen3-TTS.git demo/Qwen3-TTS
cd Qwen3-TTS/finetuning


git clone --depth=1 https://github.com/QwenLM/Qwen3-ASR.git demo/Qwen3-ASR
cd Qwen3-ASR
pip install -e .

modelscope download --model=modelscope/ollama-linux --local_dir ai-model/ollama-linux
cd ai-model/ollama-linux
chmod +x ollama-modelscope-install.sh
./ollama-modelscope-install.sh

ollama run qwen3.5:cloud


```


webui

``` shell

# 安装webui
curl -LsSf https://astral.sh/uv/install.sh | sh   # 或者去https://github.com/astral-sh/uv/releases下载

# 设置uv镜像
vim ~/.config/uv/uv.toml
[[index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

uv pip install numpy # 验证镜像是否生效（观察下载速度）

# DATA_DIR 是webui的数据目录，可以自定义
uvx open-webui@latest serve
# DATA_DIR=~/.open-webui uvx --python 3.12.3 open-webui@latest serve

http://localhost:8080

```


**接线**

| INMP441 引脚 | 功能     | **RK3568 连接建议**          | 说明                                                          |
| :----------- | :------- | :--------------------------- | :------------------------------------------------------------ |
| **VDD**      | 电源     | 1.8V 或 3.3V                 | 根据模块要求，RK3568 IO 通常为 1.8V/3.3V                      |
| **GND**      | 地       | GND                          | -                                                             |
| **SCK**      | 时钟     | **I2S_BCLK** (或 PDM_CLK)    | 由 RK3568 输出时钟 (1MHz~3.2MHz)                              |
| **WS**       | 声道选择 | **GND** (左) 或 **VDD** (右) | **注意：** 此引脚是静态配置，**不需要**接 CPU 的 LRCLK 引脚！ |
| **SD**       | 数据     | **I2S_SDI** (或 PDM_DI)      | 数据输入到 RK3568                                             |
| **L/R**      | -        | -                            | 同上 WS                                                       |


<br/>

esp32s3 从模式接线

|   dev   | signal | handshake |   mosi   |   miso   |   sclk   |    cs    |
| :-----: | :----: | :-------: | :------: | :------: | :------: | :------: |
| esp32s3 |  pin   |   gpio2   |  gpio12  |  gpio13  |  gpio15  |  gpio14  |
|  linux  |  pin   |     -     | gpio4-c3 | gpio4-c5 | gpio4-c2 | gpio4-c6 |