# xiaozhi-go

**Repository Path**: RayShen520/xiaozhi-go

## Basic Information

- **Project Name**: xiaozhi-go
- **Description**: 在科能服务器上部署的go的xiaozhi服务，里面有app和后端服务。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xiaozhi-go

小智 ESP32 后端服务的 Go 语言实现，包含完整后端服务与移动端 App。

---

## 项目结构

```
xiaozhi-go/
├── server/          ← Go 后端服务
│   ├── cmd/         ← 入口（server / mqtt / mock_ai）
│   ├── internal/    ← 核心逻辑（连接管理 / AI 管道 / 资源池）
│   ├── config/      ← 配置文件
│   ├── docker/      ← Docker Compose 部署（6 容器）
│   └── manager/     ← Web 管理控制台（Go 后端 + Vue 前端）
│
└── app/             ← 移动端 App（React Native / Expo）
    ├── App.tsx      ← 全功能（BLE 配网 / 聊天 / 声纹 / OTA）
    └── app.json     ← Expo 配置
```

---

## 快速开始

### 后端（Docker Compose）

```bash
cd server

# 拉取预编译镜像并启动
docker compose -f docker/docker-composer/docker-compose.yml up -d

# 或本地构建
docker compose -f docker/docker-composer/docker-compose.local.yml up -d
```

默认端口：

| 服务 | 端口 |
|------|------|
| WebSocket | 8989 |
| MQTT | 2883 |
| UDP | 8888 |
| Web 管理台 | 9080 |
| Manager API | 9081 |

### 移动端 App

```bash
cd app
npm install
npx expo prebuild
npx expo run:android   # Android
```

---

## 技术栈

| 层 | 技术 |
|------|------|
| 后端语言 | Go 1.24 |
| Web 框架 | Gin |
| AI 编排 | CloudWeGo Eino（字节跳动） |
| 语音识别 | FunASR / 阿里云 / 讯飞 / 豆包 |
| 语音合成 | EdgeTTS / 豆包 / CosyVoice |
| LLM | Ollama / OpenAI 兼容 / Dify |
| 数据库 | MySQL 8.0 |
| 向量库 | Qdrant |
| 移动端 | Expo + React Native |
| 部署 | Docker Compose（6 容器） |

---

## 当前部署

| 环境 | 服务器 | 用途 |
|------|------|------|
| 本机开发 | Docker Desktop | 开发测试 |
| FRP 穿透 | `47.98.189.188` | 外网访问（8989/2883/9080） |

## 相关仓库

| 仓库 | 说明 |
|------|------|
| [xiaozhi-server-python](https://gitee.com/RayShen520/xiaozhi-server-python) | Python 版后端（香港生产环境） |
| [hackers365/xiaozhi-esp32-server-golang](https://github.com/hackers365/xiaozhi-esp32-server-golang) | 上游 Go 后端 |

---

## 许可证

- server/: MIT，基于 [hackers365/xiaozhi-esp32-server-golang](https://github.com/hackers365/xiaozhi-esp32-server-golang)
- app/: 自有代码