https://github.com/juliengriffoul/labelx

A Flask application to manually label an existing dataset.
https://github.com/juliengriffoul/labelx

dataset-generation flask labeling-tool python

Last synced: about 1 month ago
JSON representation

A Flask application to manually label an existing dataset.

• Host: GitHub
• URL: https://github.com/juliengriffoul/labelx
• Owner: juliengriffoul
• License: gpl-3.0
• Created: 2022-05-28T14:30:47.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2022-09-20T17:36:49.000Z (almost 4 years ago)
• Last Synced: 2025-08-18T08:28:41.714Z (11 months ago)
• Topics: dataset-generation, flask, labeling-tool, python
• Language: Python
• Homepage:
• Size: 2.08 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# labelx

![GitHub](https://img.shields.io/github/license/juliengriffoul/labelx)

![GitHub last commit (branch)](https://img.shields.io/github/last-commit/juliengriffoul/labelx/main?label=last%20commit%20on%20main)

![GitHub Workflow Status (branch)](https://img.shields.io/github/workflow/status/juliengriffoul/labelx/makefile/main)  

A Flask application to manually label an existing dataset.

### Example scenario

You want to create a training dataset for your next model. You have your `assets/cars.csv` with already several fields:

```

Car;MPG;Cylinders;Displacement;Horsepower;Weight;Acceleration;Model;Origin

```

On top of these, you want to add a custom field with a special value that actually, just a human can set.

For example: `Good_Looking`, with two possible values `Yes` and `Ǹo`.  

The objective is to go through a maximum of dataset rows and set this value.

Iterating manually over the CSV file is not the more efficient way to do it.  

With this project, you define the label settings and the labelling interface appearance and quickier your manual labelling.

### Demo



    



### Configuration

Update the `config.json` file to configure project.

```

{

    "data": {

        "input": "assets/cars.csv",

        "output": "assets/labelled_cars.csv",

        "delimiter": ";"

    },

    "interface": {

        "fields": ["Car", "Model", "Origin"],

        "theme": "light"

    },

    "label": {

        "name": "Good_Looking",

        "values": ["Yes", "No"]

    }

}

```

### Setup instructions

1. Installing virtual environment:

```

python3 -m pip install --user virtualenv

python3 -m venv env

source env/bin/activate

```

2. Installing dependencies:

```

make

```

3. Starting project:

```

make run

```

Labelling interface now available at `http://127.0.0.1:5000`.

### Roadmap

- Fix setuptools configuration;

    - Replace with Poetry?

- Improve CI (linting, etc.);

- Setup release flow;

- Implement skip button;

- Local Bootstrap.