HOSM Nepal – Dataset annotation tools

Requirements

• uv Python package and project manager
• npm Node.js package manager
• Make

Deploying locally

Clone the repository with submodules:

git clone
cd tech4dev-hosm
git submodule update --init

Setup your environment by running:

make install

Backend

In one shell, run:

make run-db
make run-backend

The interactive API documentation will be available at http://localhost:8000/docs.

Frontend

In another shell, run:

make run-frontend

The website will be available at http://localhost:9000.

Development

Annotation library

This project uses a custom fork of Annotorious that adds undo functionality during polygon creation. To update and publish the Annotorious package:

# From the cloned Annotorious repository
npm install
npm run build
npm pack --workspaces
gh release create <tag> *.tgz

If the GitHub release already exists, you can replace the assets with:

gh release upload <tag> *.tgz --clobber

Generate test data

To generate test data, run the following command after starting the database:

make generate-mock-data

Generate tiles

To generate .dzi tiles for a directory of images (recursively), run the following command:

make generate-tiles <input_directory> <output_directory>

Existing tiles will be skipped.