LabelFast

LabelFast 是一个基于 Streamlit 的多功能标注与评测工具，支持模型快速调用、Agent 评测、语音识别任务、文档切片和数据构造等工作流。

功能概览

• 快速调用：统一入口调用大模型，批量跑测
• 评测 agents：ReAct模式的agent，可用于数据处理和批量跑测、分析
• Chatbot：会话式交互测试
• 语音识别：ASR 任务提交、异步处理与结果管理
• 云梯调用：云端调用与配置管理
• 文档切片：文档处理与切片能力
• 数据构造：数据生成与加工工。
• 系统管理：用户与模型配置管理（管理员可见）

项目结构

LabelFast/
├── app.py                    # Streamlit 入口
├── app_pages/                # 各页面功能模块
├── config/
│   └── settings_template.py  # 配置模板（需复制为 settings.py）
├── daemon/
│   ├── asr_daemon.py         # ASR 后台守护进程
│   └── start_asr_daemon.sh   # 守护进程启动脚本
├── utils/                    # 公共工具与鉴权逻辑
├── requirements.txt
└── .streamlit/
    └── secrets.toml          # 本地密钥与账号配置（不应提交）

环境要求

• Python 3.10+（建议）
• macOS / Linux（Windows 也可运行，但守护脚本需自行调整）

安装步骤

1. 克隆仓库并进入目录

git clone git@github.com:alvis-HaoH/LabelFast.git
cd LabelFast

2. 创建并激活虚拟环境

python3 -m venv .venv
source .venv/bin/activate

3. 安装依赖

pip install -r requirements.txt

配置说明

1) 模型与 API 配置

复制模板并填写：

cp config/settings_template.py config/settings.py

重点配置项：

• API_CONFIG.base_url
• API_CONFIG.api_key
• ASR_CONFIG.appid
• ASR_CONFIG.access_token
• MODEL_CONFIG 中各模型的 id

2) 登录账号与可选用户覆盖配置

在项目根目录创建 .streamlit/secrets.toml，至少包含登录账号信息。示例：

[passwords.admin]
account = "admin"
password = "your_password"
role = "admin"
display = "管理员"

可选：在 secrets.toml 中增加用户级 API / 模型覆盖（代码已支持读取 providers.volcengine.*）。

运行项目

streamlit run app.py

默认会启动 Web 界面，使用 secrets.toml 中账号登录后进入系统。

ASR 守护进程（可选）

用于异步处理语音识别任务：

cd daemon
bash start_asr_daemon.sh start

常用命令：

bash start_asr_daemon.sh start
bash start_asr_daemon.sh stop
bash start_asr_daemon.sh restart
bash start_asr_daemon.sh status
bash start_asr_daemon.sh logs -f

常见问题

• 找不到 config.settings： 确认已执行 cp config/settings_template.py config/settings.py。
• 登录失败或提示缺少账号配置： 检查 .streamlit/secrets.toml 是否存在且包含 [passwords.xxx] 配置。
• ASR 任务无结果： 检查 daemon/asr_daemon.log 与 config/settings.py 中 ASR 参数是否正确。

安全建议

• 不要将 config/settings.py、.streamlit/secrets.toml、任何 API Key/Token 提交到 Git。