
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-studio如果你准备二次开发 Label Studio这份指南帮你把源码环境从零跑起来前后端本地启动、依赖安装、热重载调试一次配齐改一行代码立刻在浏览器里看到结果不用反复刷新。跑起来之后你拥有什么内容说明完整可用的开发环境打开http://localhost:8080进入 Label Studio前后端分离、本地热重载前端开发服务器运行在http://localhost:8010支持热模块替换HMR保存即更新后端 Django 服务器http://localhost:8080基于 SQLite改完代码自动重载环境准备与必要工具硬件上双核 CPU、4GB 内存、2GB 磁盘空间即可Linux 和 macOS 直接可用Windows 建议走 WSL2。工具只需要三样版本以pyproject.toml和web/package.json为准Python 3.10后端是 Django 应用由 label_studio/core/settings/label_studio.py 驱动uv按uv.lock锁定版本安装后端依赖bun 1.3.11按web/bun.lock安装前端依赖克隆到启动的最小路径按顺序执行每一步都在项目根目录操作。先克隆仓库git clone https://gitcode.com/GitHub_Trending/la/label-studio cd label-studio按锁定文件安装后端 Python 依赖uv sync生成开发环境变量文件FRONTEND_HMR等配置就写在这里cp .env.development .env把数据库迁移应用到本地 SQLitemake migrate-dev启动后端开发服务器跑在 8080 端口make run-dev另开一个终端安装前端依赖并启动开发服务器跑在 8010 端口cd web bun install --frozen-lockfile bun run dev项目里make frontend-dev等价于在web目录执行bun run dev用哪个都行。最后确认.env里这三行FRONTEND_HMRtrue FRONTEND_HOSTNAMEhttp://localhost:8010 DJANGO_HOSTNAMEhttp://localhost:8080此时打开http://localhost:8080看到的就是带热重载的 Label Studio 界面。前后端分离的架构决定了它必须两个终端同时在线这一步不用偷懒。改一行代码即时生效热重载的工作流是「改哪 → 发生什么」改web/下任意 JSX/TS 组件比如 web/apps/labelstudio 里某个界面文件保存后 Vite 通过 8010 端口的 HMR 服务器把变更推给浏览器几秒内自动重绘无需刷新。改label_studio/下任意 Python 代码Django 开发服务器检测到文件变化自动重启下一次请求即生效。最小改动示例在web/apps/labelstudio下打开一个界面组件把某处标题文案改掉h1我的自定义标注平台/h1保存回到浏览器——文字已经变了。这就是整个热重载链路在工作前后端都不用动。踩坑速查8080 页面只有空白骨架、前端资源不加载→ 原因HMR 未启用.env没建或没被读取 → 确认根目录存在.env且含FRONTEND_HMRtrue两个终端都在跑。Python 依赖安装冲突、版本装不进来→ 原因uv 本地缓存与锁定文件状态不一致 → 修复uv cache clean uv sync启动时报数据库连接错误→ 原因手动runserver时没带开发环境变量 → 一律用make run-dev启动它会注入DJANGO_DBsqlite和调试设置。8010 前端页面连不上 8080 的 API→ 原因.env里前后端地址写错 → 核对FRONTEND_HOSTNAME与DJANGO_HOSTNAME两个值。附录命令速查与关键文件命令作用make run-dev启动后端开发服务器SQLitemake frontend-dev启动前端热重载开发服务器make migrate-dev应用数据库迁移make fmt格式化当前分支改动的文件make test运行后端单元测试关键文件Makefile所有开发命令的集合.env.development开发环境变量模板复制为.env使用web/package.json前端脚本与 bun 版本声明label_studio/core/settings/label_studio.pyDjango 设置label_studio/manage.py后端入口延伸阅读安装指南docs/source/guide/install.md故障排除docs/source/guide/install_troubleshoot.mdAPI 参考docs/source/guide/api.md前端工程说明web/README.md环境跑通后下一步创建一个项目导入一份数据跑通「导入任务 → 配置标注 → Web 标注 → 导出结果」的完整流程或者直接在web/apps/labelstudio里挑一个组件开始你的第一次改造。【免费下载链接】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),仅供参考