# model-play

**Repository Path**: feifei14119/model-play

## Basic Information

- **Project Name**: model-play
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 工作室

本项目是本机 AI 工具入口页，提供统一 Portal 页面，并把不同 AI 服务集中到一个网页中访问。

当前主要包含：

- Portal 入口页：`index.html` + `portal.py`，运行在 `8080` 端口。
- LLM 对话服务：`llm/web_ui.py` + `llm/engine_transformer.py`，运行在 `7862` 端口。
- 文生图入口：Portal 预留 `7860` 端口入口。
- 照片转卡通入口：Portal 预留 `7861` 端口入口。

Portal 页面会根据当前访问的主机名动态生成跳转链接。本机访问时跳到 `127.0.0.1`，局域网访问时跳到同一台服务器的局域网 IP。

## 目录结构

```text
model-play/
|-- README.md          # 项目总说明
|-- index.html         # Portal 入口页
|-- portal.py          # 静态入口页服务
|-- start_all.sh       # 一键启动服务
|-- stop_all.sh        # 一键停止服务
|-- logs/              # 运行日志和 PID 文件
`-- llm/
    |-- README.md      # LLM 服务说明
    |-- web_ui.py      # LLM Web UI
    |-- engine_transformer.py # transformers 模型加载和推理逻辑
    `-- requirements.txt
```

## 启动服务

在项目根目录执行：

```bash
cd /home/feifei/repo/model-play
bash start_all.sh
```

脚本会自动完成：

- 检查并创建 `llm/venv`。
- 安装 LLM 服务依赖。
- 停止旧的 Portal / LLM 进程。
- 启动 Portal 入口页。
- 启动 LLM 对话服务。
- 检查 `8080` 和 `7862` 端口是否可用。

默认 LLM 模型优先使用：

```text
/home/feifei/models/Qwen3.5-4B
```

也可以启动时指定模型：

```bash
MODEL_DIR=/home/feifei/models/你的模型目录 bash start_all.sh
```

## 访问地址

本机访问：

- Portal：`http://127.0.0.1:8080`
- LLM 对话：`http://127.0.0.1:7862`

局域网访问：

- Portal：`http://<服务器局域网IP>:8080`
- LLM 对话：`http://<服务器局域网IP>:7862`

查看本机局域网 IP：

```bash
hostname -I
```

## 停止服务

在项目根目录执行：

```bash
cd /home/feifei/repo/model-play
bash stop_all.sh
```

该脚本会停止：

- `web_ui.py`，即 LLM 对话服务。
- `portal.py`，即 Portal 入口页服务。

## 查看日志

启动后日志在：

```text
logs/portal.log
logs/llm.log
```

查看服务是否监听：

```bash
ss -tlnp | rg ':(8080|7862) '
```