<div align="center">

# QAnnotate

### Professional annotation tool for geospatial deep learning

<p>
  <img src="https://img.shields.io/badge/QGIS-3.40%20LTE-589632?style=for-the-badge&logo=qgis&logoColor=white" alt="QGIS"/>
  <img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python"/>
  <img src="https://img.shields.io/badge/Release-0.9.0-blue?style=for-the-badge" alt="Release"/>
  <img src="https://img.shields.io/badge/License-GPLv2+-green?style=for-the-badge" alt="License"/>
</p>

<p>
  <a href="https://qgeoai.nextelia.fr">📚 Documentation</a> •
  <a href="https://github.com/nextelia/qgeoai_server">🖥️ Server</a>
</p>

<img src="assets/logo.png" alt="Qgeoai" width="1024"/>

---

**Create production-ready training datasets for deep learning directly in QGIS**

</div>

## Key Features

<div align="center">
<table>
<tr>
<td width="50%">

**Smart Annotation**
- Manual tools: polygon, rectangle, ellipse, holes
- SAM2 AI-assisted segmentation
- Interactive multi-point refinement
- Session-based workflows

</td>
<td width="50%">

**Multi-Format Export**
- COCO JSON (instance segmentation)
- YOLO11 (detect/seg/obb)
- Semantic masks (TIFF/PNG)
- Incremental dataset building

</td>
</tr>
</table>
</div>

## Interface

<div align="center">
<img src="assets/qa_ui.png" alt="QAnnotate ui" width="1024"/>
</div>

## Quick Start

### Prerequisites

- **QGIS 3.40 LTE** or higher
- **[QGeoAI Server](https://github.com/nextelia/qgeoai_server)** for SAM2 support

### Installation

1. Download the plugin from [Releases](../../releases) or clone this repository
2. Copy `qannotate/` to your QGIS plugins directory:
```bash
   # Windows
   %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\
   
   # Linux
   ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/
   
   # macOS
   ~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/
```
3. Restart QGIS and enable the plugin via `Plugins` → `Manage and Install Plugins`

**Full documentation**: [qgeoai.nextelia.fr](https://qgeoai.nextelia.fr)

##  Why QAnnotate?

- ✅ **Professional-grade**: Built for production workflows
- ✅ **AI-powered**: SAM2 integration for fast, accurate annotations
- ✅ **Geospatial native**: Preserves CRS, multi-band rasters, metadata
- ✅ **Open source**: GPLv2+ license, fully auditable
- ✅ **Production-ready**: Used by French territorial collectivities

## Support & Contribution

### Community Support

**Documentation**: [qgeoai.nextelia.fr](https://qgeoai.nextelia.fr)

### Professional Support

For operational support, custom integrations, or training:

- **Email**: [hello@nextelia.fr](mailto:hello@nextelia.fr)
- **Website**: [nextelia.fr](https://www.nextelia.fr)

The suite is free and open-source. Professional services ensure sustainable development.

### Contributing

This project is developed as an open, production-grade GeoAI platform for QGIS.

We welcome:
- Bug reports with reproducible steps
- Documentation improvements
- Real-world feedback

For larger changes, new features or architectural modifications, please open an issue first to discuss alignment with the project roadmap.

The roadmap is maintained by the core team to ensure long-term stability, consistency and production readiness.

---

<div align="center">

**Part of [QGeoAI Tools](https://qgeoai.nextelia.fr)** suite

**Copyright** © 2026 Nextelia® • **Version** 0.9.0 • **Updated** January 15, 2026

</div>
