Skip to main content

A labelling tool for satellite imagery

Project description

Annotate satellite imagery for training AI models.

Pip Version

SCANEO is a labelling tool for annotating satellite images. Its primary goal is to improve the efficiency of the creation of training datasets for AI models. To that end, SCANEO features an intuitive labelling interface and assisted labelling capabilities. Current capabilities include:

  • Create labelling campaigns from local or remote data
  • Annotate images for classification, detection and segmentation tasks
  • Assisted labelling with AI models
  • Export annotations in GeoJSON format
  • Integration with EOTDL.

Why SCANEO?

The development and deployment of AI models for Earth Observation (EO) applications faces significant challenges due to the scarcity of high-quality, well-annotated training datasets. This data bottleneck stems from several factors: the complex nature of satellite imagery, which requires domain expertise for accurate labeling; the high costs associated with data acquisition and manual annotation; and the technical challenges in preprocessing and standardizing multi-source EO data. These limitations have created a substantial gap between the potential applications of AI in Earth Observation and its current implementation, particularly when compared to more mature AI applications in other domains where training data is more readily available and easier to process.

To address some of these challenges, SCANEO provides a web-based annotation platform that combines artificial intelligence and active learning techniques to accelerate the creation of training datasets from satellite imagery.

Installation

We recommend using uv to install SCANEO.

uv init
uv add scaneo

Is is recommended to upgrade the package regularly, in order to get the latest changes.

uv add scaneo --upgrade

Usage

You can launch scaneo with a single command:

scaneo

This will launch the UI, which will be accessible on your localhost:8000.

To learn more about the CLI and options, run:

scaneo --help

Documentation and tutorials

To view the documentation, launch the UI and go to localhost:8000/docs.

Contributing

See CONTRIBUTING.md for more information.

Development

This repository contains the source code for SCANEO.

  • scaneo: includes the CLI and the API.
  • ui: includes the web application UI.
  • inference: includes a simple inference API.

First, clone the repository and install the dependencies:

git clone https://github.com/earthpulse/scaneo.git
cd scaneo
uv sync

Run the API with the CLI:

make dev

Then, run the UI:

cd ui
bun run dev

Remember to create the .env file from .env.example cp .env.example .env

Build

In the UI, create .env.production with an empty PUBLIC_API_URL.

Then, build the Python package:

make build v=0.1.0

The v parameter is the version of the package, change it to the desired version.

Inference

You can run the sample inference API to test the assisted labelling capabilities.

First, get the models and samples from EOTDL:

uv run eotdl models get SCANEO -p eotdl -a -f

Then, move the models and samples to the inference folder:

mv eotdl/SCANEO/models inference/models
mv eotdl/SCANEO/samples inference/samples

Finally, start the inference API:

make inference

You can test the models in the inference notebook.

Notes

Do not add scaneo/ui to gitignore since the build process will fail (missing entry folder).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scaneo-2025.6.18.post7.tar.gz (19.1 MB view details)

Uploaded Source

Built Distribution

scaneo-2025.6.18.post7-py3-none-any.whl (6.7 MB view details)

Uploaded Python 3

File details

Details for the file scaneo-2025.6.18.post7.tar.gz.

File metadata

  • Download URL: scaneo-2025.6.18.post7.tar.gz
  • Upload date:
  • Size: 19.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.5.6

File hashes

Hashes for scaneo-2025.6.18.post7.tar.gz
Algorithm Hash digest
SHA256 77875d7e7dd2a5775393db139b8005d6ecbc3af09e3653d903ac3565d222b2dc
MD5 c0a7b9448ea2825c9f037ef545abe86f
BLAKE2b-256 481ec5abd928e4f2ed4363c89bb3a369a20ac4207f348d9b003f7f61b1813dcf

See more details on using hashes here.

File details

Details for the file scaneo-2025.6.18.post7-py3-none-any.whl.

File metadata

File hashes

Hashes for scaneo-2025.6.18.post7-py3-none-any.whl
Algorithm Hash digest
SHA256 8aa87823155eaac105ac3c62bbbc4eb5d6aa00a12c38432843f0350b4bde27b4
MD5 522be4045e1165c1b50076a5298aba7b
BLAKE2b-256 e58af7656c4d4e18d96342d77263657b3fde82fb3ffcda5f2e8689b195b4e46d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page