Skip to content

Get started with doccano

What is doccano?

doccano is an open-source data labeling tool for machine learning practitioners. You can use doccano to perform different types of labeling tasks with many data formats. To see what doccano can do, try the doccano demo.

Demo image

You can also integrate doccano with your script via the doccano REST APIs. By using the doccano APIs, you can label your data by using some machine learning model.

Doccano labeling workflow

To complete a labeling project with doccano:

  1. Install doccano.
  2. Run doccano.
  3. Set up the labeling project. Select the type of labeling project and configure project settings.
  4. Import your dataset. You can also import labeled datasets.
  5. Add users to the project.
  6. Define the annotation guideline.
  7. Start labeling the data.
  8. Export the labeled dataset.


  1. Install doccano with pip (Python 3.8+):

    bash pip install doccano

  2. Run doccano:

     doccano init
     doccano createuser
     doccano webserver
     # In another terminal, run the command:
     doccano task
  3. Open the doccano UI at http://localhost:8000/auth.

  4. Sign in with the username and password created by doccano createuser.

    The default is username: admin, password: password.

  5. Change the default admin password at http://localhost:8000/admin/password_change/.

  6. Return to the doccano UI at http://localhost:8000/projects?.
  7. Create a project for labeling data. Click Create, select a project type, and fill out project details.
  8. Import a dataset. Go to the Dataset page and click Actions > Import Dataset and import the dataset you want to use.
  9. Click Annotate and label the data.
  10. When you're finished, export the labeled dataset. Go to the Dataset page and click Actions > Export dataset.


You can customize doccano to suit your needs. The architecture of doccano consists of two parts: backend and frontend.

Module Technology Description
doccano backend Python, Django, and Django Rest Framework Perform data labeling via REST APIs.
doccano frontend Javascript web app using Vue.js and Nuxt.js Perform data labeling in a user interface.


If you get stuck, check the FAQ.

For help and feedback, feel free to contact the author.