项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 28662
使用教程
环境要求
- 已安装 Docker(若用 pip/conda 本地安装则需 Python 与 pip)
- 宿主机 8080 端口未被占用;Docker Compose 方式占用 80 端口
- 用于挂载的本地目录 $(pwd)/mydata 需可写,容器内挂载点为 /label-studio/data
- Docker Compose 方式需可用 docker-compose;MinIO 方式需 docker compose 并可能需改 hosts 文件
- Windows 上 pip 安装需先从 Gohlke builds 下载匹配 Python 版本的 lxml wheel
安装与启动步骤
-
1拉取官方镜像
从 Docker Hub 下载 Label Studio 官方最新镜像,这是 README 推荐的本地安装方式。
docker pull heartexlabs/label-studio:latest -
2启动容器
映射 8080 端口,并用 -v 把数据目录挂到本地 mydata,容器内路径固定为 /label-studio/data。
docker run -it -p 8080:8080 -v $(pwd)/mydata:/label-studio/data heartexlabs/label-studio:latest -
3覆盖默认启动命令
可选:在镜像名后追加参数覆盖默认启动命令,例如把日志级别改为 DEBUG 便于排查。
docker run -it -p 8080:8080 -v $(pwd)/mydata:/label-studio/data heartexlabs/label-studio:latest label-studio --log-level DEBUG -
4Compose 生产部署
用自带编排启动 Label Studio + Nginx + PostgreSQL 的生产级组合,从 80 端口访问。
docker-compose up -
5叠加 MinIO 存储
再叠加 minio 编排文件,额外启动 MinIO 用于本地测试 S3 存储;无固定 IP 需配置 hosts。
docker compose -f docker-compose.yml -f docker-compose.minio.yml up -d -
6Conda 本地安装
README 给出的 Anaconda 安装路径:创建并激活环境、安装 psycopg2,再 pip 安装 label-studio。
conda create --name label-studio conda activate label-studio conda install psycopg2 pip install label-studio -
7本地开发安装
从源码跑最新版:装 poetry 与依赖,再执行数据库迁移和静态文件收集。
pip install poetry poetry install python label_studio/manage.py migrate python label_studio/manage.py collectstatic
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
端口映射 | 是 | 容器 8080 映射到宿主机端口,决定浏览器访问地址 | -p 8080:8080 |
数据挂载目录 | 是 | 把容器 /label-studio/data 挂到本地,持久化数据库与上传文件 | -v $(pwd)/mydata:/label-studio/data |
日志级别 | 否 | 追加在镜像名后覆盖默认启动命令,便于排查问题 | --log-level DEBUG |
如何确认成功
浏览器打开 http://localhost:8080 能看到 Label Studio 界面;Compose 方式访问 http://localhost,并确认 mydata 目录下生成 label_studio.sqlite3。
常见问题
Q:标注数据保存在哪里?
A:保存在挂载的 ./mydata 目录中,包含 SQLite3 数据库 label_studio.sqlite3 以及上传的文件,删除目录即清空数据。
Q:8080 端口被占用怎么办?
A:修改 -p 参数前面的宿主机端口即可,例如 -p 8081:8080,然后访问 http://localhost:8081;注意 Compose 方式默认走 80 端口。
Q:Compose 和单容器有什么区别?
A:Compose 组合额外包含 Nginx 代理与 PostgreSQL,属于生产就绪栈,默认从 http://localhost 访问,性能优于 SQLite3。
Q:为什么要用 MinIO 版本?
A:用于在本地测试 S3 存储行为;若没有固定 IP,需要在 hosts 文件中加条目,让 Label Studio 和浏览器都能访问 MinIO。
Q:怎么接入自己的机器学习模型?
A:先启动自己的 ML backend 服务(参考 label-studio-ml-backend),再到项目设置的 model 页面连接,即可做预标注、在线学习和主动学习。
注意事项
- 单容器方式访问 8080 端口,Docker Compose 方式访问 80 端口,两者地址不同勿混淆。
- 官方镜像名为 heartexlabs/label-studio,默认使用 SQLite3,生产环境建议改用 Compose 中的 PostgreSQL。
- Windows 用户用 pip 安装前,需先从 Gohlke builds 下载对应版本的 lxml wheel 并先安装。
- 从源码开发安装后必须执行 migrate 与 collectstatic,否则应用无法正常启动。
核心亮点
- 支持图像、文本、音频、视频等多类型数据标注,内置多种标注模板,覆盖主流AI场景
- 提供标准化输出格式,可直接对接模型训练流程,降低数据预处理成本
- 支持多人协作与项目管理,具备标注任务分配、审核和质量控制功能
不足之处
- 大型数据集或复杂标注任务下性能可能下降,需优化配置
- 文档/社区待观察
适用场景
- 计算机视觉项目中的图像分类、目标检测、语义分割标注
- 自然语言处理任务中的文本分类、实体识别、关系抽取标注
- 多模态数据集构建,如音视频结合文本的标注
替代项目
CVAT、SuperAnnotate、Prodigy
同类项目推荐
labelbox-python
开源
用 Python 快速接入 Labelbox,自动化构建高质量 AI 训练数据集。
The data factory for next gen AI
University1652-Baseline
开源
拿无人机图像定位全球建筑,跨视角检索基准一键跑通
ACM Multimedia2020 University-1652: A Multi-view Multi-source Benchmark for Drone-ba···
BTC-Trading-Since-2020
开源
下载2020年至今的比特币真实交易数据,直接用于策略研究和AI训练
Public BTC trading context since 2020.
synthetic-data-generator
开源
一键生成高仿真表格数据,解决隐私与数据稀缺难题
SDG is a specialized framework designed to generate high-quality structured tabular ···
tfrecord
开源
不装 TensorFlow 也能读写 TFRecord,直接接 PyTorch
Standalone TFRecord reader/writer with PyTorch data loaders
datamimic
开源
按模型一键造出合规可复现的测试数据
Model-driven synthetic test data for CI/CD and analytics - deterministic, privacy-pr···
autolabel
开源
用 LLM 自动标注文本数据,省时省力
Label, clean and enrich text datasets with LLMs.
SpatialVID
开源
给视频加空间标注,让 AI 生成时懂几何、懂运动
[CVPR 2026] SpatialVID: A Large-Scale Video Dataset with Spatial Annotations
opendataloader-pdf
开源
把 PDF 变成 AI 能直接吃的数据,省去清洗烦恼
PDF Parser for AI-ready data. Automate PDF accessibility. Open-source.
