引言
doccano 是一款面向机器学习从业者的开源数据标记工具。您可以使用 doccano 执行不同类型的标记任务,支持多种数据格式。要了解 doccano 的功能,请试用doccano 演示版。
1.软件下载
git clone https://github.com/doccano/doccano.git
cd doccano
2.前后端依赖下载
doccano 后端内置于 Python 3.8+ 中,并使用Poetry作为依赖项管理器。首先我们下载Poetry。
我们使用pipx安装Poetry,如果没有安装pipx,请运行以下命令安装:
sudo apt update
sudo apt install pipx
pipx ensurepath
#允许全局范围内的 pipx 操作。
sudo pipx ensurepath --global
#查看版本
pipx --version
如果apt更新失败,修改以下文件
sudo nano /etc/apt/sources.list.d/ubuntu.sources
在文件中,将 cn.archive.ubuntu.com
替换为其他可靠的镜像源,例如 mirrors.ustc.edu.cn
或 mirrors.aliyun.com
。
接下来安装Poetry
pipx install poetry
#让 pipx 自动将 ~/.local/bin 添加到你的 PATH 环境变量中
pipx ensurepath
需要 打开一个新的终端窗口。
后端依赖安装
#先使用anaconda3创建一个虚拟环境
source ~/anaconda3/bin/activate
#python版本选择3.10不会有依赖冲突
conda create -n doccano python=3.10
conda activate doccano
#进入后端
cd backend
poetry install
#已经有创建的虚拟环境doccano,不需要运行了
poetry shell
前端依赖安装
先安装yarn
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update
sudo apt install yarn
#验证安装
yarn --version
#安装前端依赖
cd frontend
yarn install
3.启动项目
后端:
cd backend
python manage.py migrate
python manage.py create_roles
python manage.py create_admin --noinput --username "admin" --email "admin@example.com" --password "password"
python manage.py runserver
在另一个终端中,您需要运行 Celery 来使用导入/导出数据集功能:
cd backend
celery --app=config worker --loglevel=INFO --concurrency=1
前端:
yarn dev
直接访问:
源码有一个问题,创建项目会报错,因为跨域问题:
需要修改doccano/doccano-master/backend/config/settings/base.py
把前端的IP地址和端口号加进去CSRF_TRUSTED_ORIGINS。
最后
如果不需要改源码建议pip直接安装
官方文档:Install and upgrade doccano - doccano
安装命令:
要使用 pip 安装 doccano,您需要 Python 3.8+。运行以下命令:
pip install doccano
安装 doccano 后,使用以下命令启动服务器:
# Initialize database. First time only.
doccano init
# Create a super user. First time only.
doccano createuser --username admin --password pass
# Start a web server.
doccano webserver --port 8000
在另一个终端中,运行以下命令:
# Start the task queue to handle file upload/download.
doccano task