A powerful, modern image labeling tool built with React.js, TypeScript, TailwindCSS, Framer Motion, and Dexie.js, designed for creating high-quality datasets for machine learning models. Supports manual annotation, free drawing, and AI-assisted labeling using YOLOv8 models.
- ✨ Features
- 📂 Sub-Projects
- 📸 Demo Screenshots
- 🚀 Getting Started
- 📦 Export Formats
- 🤖 AI Auto-Labeling (YOLOv8 Integration)
- 📝 Roadmap
- 🤝 Contributing
- 📄 License
- Acknowledgements
Download the latest release from the Releases page.
- If you see a warning about an unsigned app, see our desktop installation guide for troubleshooting steps.
- Username:
admin@vailabel.com - Password:
admin123 - Web App
- Visit https://studio.vailabel.com to use the web-based labeling tool.
- 🚀 Project Management: Create, Save, Load, and Export labeling projects offline using SQLite.
- 🖌️ Manual Annotation: Draw bounding boxes, polygons, and freehand shapes on images.
- 📈 Custom Canvas Tools: Zoom, Pan, Resizable Divider, Ruler Guides, Dynamic Cursor Coordinates.
- ⚡ AI Auto-Labeling: Integrate YOLOv8 models to automatically detect and label objects.
- 🖱️ Custom Right-Click Menu: Quick tool switching with context menu.
- 🗃️ Multi-Format Export: Export labeled datasets in COCO JSON, Pascal VOC XML, YOLO TXT, and Simple JSON formats.
- 🌓 Light/Dark Mode: Modern UI with full responsive design.
- 💾 Offline Support: Save your projects locally without any backend required.
- 🖥️ Desktop Application: Support Multi-platform Desktop app for Mac/Window/Linux.
| Sub-Project | Description |
|---|---|
| Desktop | 🖥️ Multi-platform desktop application for Mac, Windows, and Linux. |
| Studio | 🌐 Web-based image labeling tool with advanced features like AI-assisted labeling. |
| API | 🖥️ FastAPI server for running YOLOv8 & web-based inference. |
| Web | 📚 Documentation and updates site for the project. |
- 🛠️ Node.js >= 20
- 📦 yarn (latest version)
# Option 1: Enable Corepack (recommended)
corepack enable
# Option 2: Install yarn globally
npm install -g yarn# Clone the repository
git clone https://github.com/vailabel/vailabel-studio.git
# Go into the project directory
cd vailabel-studio
# Install dependencies
yarn install
# Run the development server
yarn dev| Command | Description |
|---|---|
yarn dev |
Start the development server both desktop and web |
yarn build |
Build the project for production |
yarn lint |
Run ESLint to check for code quality |
yarn format |
Format the code using Prettier |
yarn test |
Run tests using Jest/Vitest |
yarn desktop |
Start the desktop application development server with studio app |
yarn studio |
Start the web-based labeling tool |
yarn api |
Start the FastAPI server for YOLOv8 inference |
yarn web |
Start the documentation site |
- COCO JSON: 🐒 Object detection format used in MS COCO dataset.
- Pascal VOC: 📄 XML annotation format.
- YOLO TXT: 🦁 YOLO label format (class x_center y_center width height).
- Simple JSON: 📋 Flat JSON export of annotations.
- Click "Auto Detect with AI" button to run YOLOv8 model.
- Bounding boxes predicted by the AI will automatically appear on the canvas.
- Supports using pre-trained or custom YOLOv8 models.
- (Optional: Connect to a lightweight FastAPI server if browser-based inference is too heavy.)
- ✏️ Free Drawing (Lasso Tool)
- 💾 Offline Project Storage
- 🖼️ Multi-Image Labeling Projects
- 🖥️ Desktop App (Electron)
- 🤖 AI YOLOv8 Auto-Detection (In Progress)
- 🛠️ Custom Model Training Pipeline
- 📤 Export Multiple Formats (In Progress) YOLO, Pascal VOC, COCO
- 🏷️ Multi-Class Annotation (Class Picker)
- 🎥 Video Frame-by-Frame Annotation
- 🖼️ Image Segmentation (Polygon)
- 🖼️ Text Annotation (OCR)
- 👥 Collaborative Labeling (Team mode) - Cloud Self-host
- 📝 Task Assignment & Review System
- ☁️ Cloud Storage Integration (S3, GCS, Azure)
- 🔒 OAuth2 User Authentication (Google, GitHub, etc.)
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
For detailed guidelines, see the Contributing Guide.
This project is licensed under the GNU GENERAL PUBLIC LICENSE — see the LICENSE file for details.
- Ultralytics YOLOv8
- TailwindCSS
- Framer Motion
- Inspiration: Roboflow, Label Studio, CVAT