README.md

# Kimodo 项目

完全自包含的 Kimodo 项目，无需预先安装任何依赖。

## 快速启动

```bash
./start.sh
```

访问地址：http://localhost:7860

## 环境信息

- **Python**: 3.10.20 (`/workspace/env/kimodo/`)
- **工具链**: cmake 3.28.3, gcc 13.3.0, make 4.3 (`/workspace/tools/`)
- **模型**: 本地缓存 (`/workspace/.cache/huggingface/`)
- **Text Encoder**: `/workspace/kimodo/McGill-NLP/`

## 自定义启动

```bash
# 自定义端口
SERVER_PORT=8080 ./start.sh

# 自定义服务器地址
SERVER_NAME=127.0.0.1 ./start.sh
```

## 服务管理

```bash
# 查看进程
ps aux | grep kimodo

# 停止服务
pkill -f kimodo

# 查看端口
ss -tlnp | grep 7860
```

## 部署到其他机器

直接复制整个 workspace 目录：

```bash
scp -r /workspace user@target:/path/to/destination
```

在目标机器上启动：`./start.sh`

## 启动成功标志

看到以下信息表示启动成功：

```
╭────── viser (listening *:7860) ───────╮
│             ╷                         │
│   HTTP      │ http://localhost:7860   │
│   Websocket │ ws://localhost:7860     │
│             ╵                         │
╰───────────────────────────────────────╯
```

## 注意事项

- 首次启动需要加载模型，约 1-2 分钟
- 所有依赖都在 workspace 内，无需外部安装
- 自动使用 GPU 加速（如果可用）