三步跑起来Label Studio 数据标注工具安装与启动完整指南【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studioLabel Studio 是一个开源的数据标注工具支持文本、图片、音频、视频和时间序列等多种数据类型的标注标注结果可以导出为统一的标准化格式直接喂给机器学习模型。如果你的目标是把手头的原始数据变成训练数据它就是一个免费的、可私有部署的答案。本文带你完成安装、启动和基础配置跑通第一个标注项目。环境准备开始安装前确认这几项安装方式不同前置条件不同。先对号入座再选路径。路径需要预装的工具适合人群Docker最省事Docker Docker Compose只想尽快用起来的用户不想碰 Python 环境pip常规Python 3.10 及以上有 Python 基础、想直接在系统里运行的用户源码开发者Python 3.10、poetry要改代码、跑测试、参与开发的人通用注意两点默认服务端口是8080如果这个端口被占用要么先停掉占用的程序要么后面换个端口启动。浏览器建议使用最新版 Chrome其他浏览器可能出现兼容问题。路径一用 Docker 一条命令装好推荐新手这是最省事的路径官方镜像里已经打包好了全部依赖不需要装任何 Python 包。先拉镜像再启动容器把本地mydata目录挂载进去用于保存数据库和上传的文件docker pull heartexlabs/label-studio:latest docker run -it -p 8080:8080 -v $(pwd)/mydata:/label-studio/data heartexlabs/label-studio:latest执行完后容器日志会打印出服务启动信息mydata目录下会出现 SQLite 数据库文件label_studio.sqlite3说明数据落地成功。如果你的目标是生产环境级别的部署可以改用 Docker Compose 拉起三件套应用 Nginx 反代 PostgreSQL 数据库。在仓库根目录执行docker compose up这条命令启动的是 docker-compose.yml 定义的完整栈比单容器方案更适合长期跑业务数据。踩坑提醒如果你还要同时起 MinIO 本地 S3 存储用于测试 S3 对象存储场景需要再加一个 Compose 文件docker compose -f docker-compose.yml -f docker-compose.minio.yml up -d由于 Label Studio 容器和浏览器都要通过主机名访问 MinIO本机没有固定 IP 时要在系统 hosts 文件里手动加一条对应记录否则存储服务会连不通。详细做法见 docs/source/guide/storedata.md。路径二用 pip 常规安装适合已有 Python 环境的人pip 安装要求 Python 3.10见 pyproject.toml 声明。强烈建议先建一个虚拟环境避免依赖污染系统 Pythonpython3 -m venv env source env/bin/activate pip install label-studio安装完成后会多出一个label-studio命令。用label-studio --version验证版本号能正常打印即代表安装成功。这一步不需要数据库、不需要改任何配置缺省即用本地 SQLite。路径三从源码安装开发者方案只有要修改代码、调试前后端时才走这条路径。先把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/la/label-studio cd label-studio然后用 poetry 装齐全部依赖执行数据库迁移和静态资源收集最后以开发模式启动pip install poetry poetry install python label_studio/manage.py migrate python label_studio/manage.py collectstatic python label_studio/manage.py runserver踩坑提醒manage.py migrate这一步不能跳过。跳过迁移会导致启动时直接报数据库表不存在的错误。前端如果还要改 UI需要单独参考 web/README.md 里的前端构建说明。首次启动与验证怎么确认服务真的跑起来了无论走哪条路径启动命令都是label-studioDocker 方式由容器自动执行。启动后默认会弹出浏览器如果没弹手动打开http://localhost:8080。确认服务正常的三个标志按顺序检查端口 8080 有响应终端执行curl -I http://localhost:8080返回 200 或 302 都算正常。浏览器打开后看到注册页面首次使用会让你填邮箱和密码创建管理员账号账号保存在本地数据库里。注册成功后进入项目列表页Projects能新建项目、导入数据说明整条链路Web 服务 数据库全部就绪。最常见的启动报错及处理Address already in use8080 端口被占。启动时加参数换端口即可如label-studio start --port 9001浏览器改访问对应端口。容器起不来、日志刷数据库连接失败Compose 方案下通常是 PostgreSQL 容器还没就绪稍等几十秒重试或删掉数据卷postgres-data重新初始化。pip 安装时报依赖编译错误确认 Python 版本在 3.10 及以上且虚拟环境是干净的Windows 用户若卡在 lxml参考 官方文档 的 Windows 安装说明。更完整的排障清单见 docs/source/guide/troubleshooting.md。关键配置速查最常用的几个变量默认配置开箱即用下面这几项是最常需要动手的地方。命令行参数和环境变量二选一即可生效配置项环境变量 / 参数默认值影响服务端口LABEL_STUDIO_PORT/--port8080浏览器访问的端口数据库文件LABEL_STUDIO_DATABASE/-dblabel_studio.sqlite3标注数据存在哪数据目录LABEL_STUDIO_BASE_DATA_DIR系统相关上传文件、导出结果的存放位置初始账号LABEL_STUDIO_USERNAME/LABEL_STUDIO_PASSWORDdefault_userlocalhost不设置则走网页注册日志级别--log-levelERROR排障时临时调成 DEBUG数据库类型DJANGO_DBsqlite单容器/ postgresqlCompose切换 SQLite 或 PostgreSQL完整参数列表见 docs/source/guide/start.md。Docker 用户可以直接把这些变量写进 Compose 目录下的.env文件不用改代码。跑起来之后常见报错速查与下一步最后汇总一张报错速查表启动阶段 90% 的问题都在这现象原因处理浏览器打不开 8080服务没起来或端口被占先curl -I http://localhost:8080再查端口占用启动报数据库表不存在源码方式没跑迁移执行python label_studio/manage.py migrateMinIO 连接超时主机名解析不通在 hosts 中补一条静态映射依赖安装失败Python 版本低于 3.10 或环境不干净新建虚拟环境用 Python 3.10 重装官方文档入口安装总览、启动参数、数据导入与存储、标注配置入门、官方文档目录。服务能访问、能注册、能建项目安装就算完成——接下来把第一个数据集导进去标注你的第一条数据。【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 三步跑起来：Label Studio 数据标注工具安装与启动完整指南
三步跑起来Label Studio 数据标注工具安装与启动完整指南【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studioLabel Studio 是一个开源的数据标注工具支持文本、图片、音频、视频和时间序列等多种数据类型的标注标注结果可以导出为统一的标准化格式直接喂给机器学习模型。如果你的目标是把手头的原始数据变成训练数据它就是一个免费的、可私有部署的答案。本文带你完成安装、启动和基础配置跑通第一个标注项目。环境准备开始安装前确认这几项安装方式不同前置条件不同。先对号入座再选路径。路径需要预装的工具适合人群Docker最省事Docker Docker Compose只想尽快用起来的用户不想碰 Python 环境pip常规Python 3.10 及以上有 Python 基础、想直接在系统里运行的用户源码开发者Python 3.10、poetry要改代码、跑测试、参与开发的人通用注意两点默认服务端口是8080如果这个端口被占用要么先停掉占用的程序要么后面换个端口启动。浏览器建议使用最新版 Chrome其他浏览器可能出现兼容问题。路径一用 Docker 一条命令装好推荐新手这是最省事的路径官方镜像里已经打包好了全部依赖不需要装任何 Python 包。先拉镜像再启动容器把本地mydata目录挂载进去用于保存数据库和上传的文件docker pull heartexlabs/label-studio:latest docker run -it -p 8080:8080 -v $(pwd)/mydata:/label-studio/data heartexlabs/label-studio:latest执行完后容器日志会打印出服务启动信息mydata目录下会出现 SQLite 数据库文件label_studio.sqlite3说明数据落地成功。如果你的目标是生产环境级别的部署可以改用 Docker Compose 拉起三件套应用 Nginx 反代 PostgreSQL 数据库。在仓库根目录执行docker compose up这条命令启动的是 docker-compose.yml 定义的完整栈比单容器方案更适合长期跑业务数据。踩坑提醒如果你还要同时起 MinIO 本地 S3 存储用于测试 S3 对象存储场景需要再加一个 Compose 文件docker compose -f docker-compose.yml -f docker-compose.minio.yml up -d由于 Label Studio 容器和浏览器都要通过主机名访问 MinIO本机没有固定 IP 时要在系统 hosts 文件里手动加一条对应记录否则存储服务会连不通。详细做法见 docs/source/guide/storedata.md。路径二用 pip 常规安装适合已有 Python 环境的人pip 安装要求 Python 3.10见 pyproject.toml 声明。强烈建议先建一个虚拟环境避免依赖污染系统 Pythonpython3 -m venv env source env/bin/activate pip install label-studio安装完成后会多出一个label-studio命令。用label-studio --version验证版本号能正常打印即代表安装成功。这一步不需要数据库、不需要改任何配置缺省即用本地 SQLite。路径三从源码安装开发者方案只有要修改代码、调试前后端时才走这条路径。先把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/la/label-studio cd label-studio然后用 poetry 装齐全部依赖执行数据库迁移和静态资源收集最后以开发模式启动pip install poetry poetry install python label_studio/manage.py migrate python label_studio/manage.py collectstatic python label_studio/manage.py runserver踩坑提醒manage.py migrate这一步不能跳过。跳过迁移会导致启动时直接报数据库表不存在的错误。前端如果还要改 UI需要单独参考 web/README.md 里的前端构建说明。首次启动与验证怎么确认服务真的跑起来了无论走哪条路径启动命令都是label-studioDocker 方式由容器自动执行。启动后默认会弹出浏览器如果没弹手动打开http://localhost:8080。确认服务正常的三个标志按顺序检查端口 8080 有响应终端执行curl -I http://localhost:8080返回 200 或 302 都算正常。浏览器打开后看到注册页面首次使用会让你填邮箱和密码创建管理员账号账号保存在本地数据库里。注册成功后进入项目列表页Projects能新建项目、导入数据说明整条链路Web 服务 数据库全部就绪。最常见的启动报错及处理Address already in use8080 端口被占。启动时加参数换端口即可如label-studio start --port 9001浏览器改访问对应端口。容器起不来、日志刷数据库连接失败Compose 方案下通常是 PostgreSQL 容器还没就绪稍等几十秒重试或删掉数据卷postgres-data重新初始化。pip 安装时报依赖编译错误确认 Python 版本在 3.10 及以上且虚拟环境是干净的Windows 用户若卡在 lxml参考 官方文档 的 Windows 安装说明。更完整的排障清单见 docs/source/guide/troubleshooting.md。关键配置速查最常用的几个变量默认配置开箱即用下面这几项是最常需要动手的地方。命令行参数和环境变量二选一即可生效配置项环境变量 / 参数默认值影响服务端口LABEL_STUDIO_PORT/--port8080浏览器访问的端口数据库文件LABEL_STUDIO_DATABASE/-dblabel_studio.sqlite3标注数据存在哪数据目录LABEL_STUDIO_BASE_DATA_DIR系统相关上传文件、导出结果的存放位置初始账号LABEL_STUDIO_USERNAME/LABEL_STUDIO_PASSWORDdefault_userlocalhost不设置则走网页注册日志级别--log-levelERROR排障时临时调成 DEBUG数据库类型DJANGO_DBsqlite单容器/ postgresqlCompose切换 SQLite 或 PostgreSQL完整参数列表见 docs/source/guide/start.md。Docker 用户可以直接把这些变量写进 Compose 目录下的.env文件不用改代码。跑起来之后常见报错速查与下一步最后汇总一张报错速查表启动阶段 90% 的问题都在这现象原因处理浏览器打不开 8080服务没起来或端口被占先curl -I http://localhost:8080再查端口占用启动报数据库表不存在源码方式没跑迁移执行python label_studio/manage.py migrateMinIO 连接超时主机名解析不通在 hosts 中补一条静态映射依赖安装失败Python 版本低于 3.10 或环境不干净新建虚拟环境用 Python 3.10 重装官方文档入口安装总览、启动参数、数据导入与存储、标注配置入门、官方文档目录。服务能访问、能注册、能建项目安装就算完成——接下来把第一个数据集导进去标注你的第一条数据。【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考