---
title: picture-book-reading-server
canonical_url: "https://www.modelscope.cn/studios/JerryWuModelScope/picture-book-reading-server"
md_url: "https://www.modelscope.cn/studios/JerryWuModelScope/picture-book-reading-server.md"
repository: JerryWuModelScope/picture-book-reading-server
chinese_name: "绘本阅读服务器"
last_updated: 2026-11-14
sdk_type: docker
sdk_version: 6.17.3
downloads: 0
stars: 1
---

# picture-book-reading-server

> picture-book-reading-server - JerryWuModelScope 在 ModelScope 创建的在线 Demo。本服务器的前端界面为硬件和客户端开发提供了方便的调试功能。

JerryWuModelScope/picture-book-reading-server 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 docker 6.17.3 构建，中文名为「绘本阅读服务器」。

- **Repository**: JerryWuModelScope/picture-book-reading-server
- **SDK**: docker
- **SDK version**: 6.17.3
- **Downloads**: 0
- **Stars**: 1
- **Last updated**: 2026-11-14

Source: https://www.modelscope.cn/studios/JerryWuModelScope/picture-book-reading-server

---

# 绘本阅读服务器

## 调试方法

本服务器的前端界面为硬件和客户端开发提供了方便的调试功能。

### 调试传感器设备

启动硬件设备后，在网页右边“客户端模拟”下面的“订阅设备 ID”文本框里输入设备的 ID。

连接成功之后，当设备提交了一个翻页事件后，在网页右边会模拟客户端的预期行为：播放音频。

### 调试客户端

先确保网页左边“传感器设备模拟”下面的心跳汇报已开启。建议关闭网页的声音播放。

待调试的客户端使用“传感器设备模拟”下面的设备 ID 作为要订阅的设备 ID。

连接成功后，在网页的图片上传框里上传一张书页图片，就会模拟一次翻页事件。客户端会收到 SSE 数据流。

## 本地运行

下面介绍如何在本地运行本服务器。

> [!TIP]
>
> 请确保你的电脑上安装了 Python（≥3.11）和 Node.js。

### 克隆仓库代码

```bash
git clone https://www.modelscope.cn/studios/JerryWuModelScope/picture-book-reading-server.git
cd picture-book-reading-server
git submodule update --init --recursive
```

### 构建前端

```bash
cd frontend
npm install
npm run build
```

### 安装后端依赖

```bash
cd ../backend
python -m pip install -r "requirements.txt"
modelscope download --model JerryWuModelScope/doc-corner
```

### 启动后端

```bash
python main.py
```

默认运行在 0.0.0.0:8080，可以通过 `.env` 设置。
