The LabelGenerator is a simple webapp, build with Flask. It serves png and jpeg image of our labels with dynamic strings on it. You can choose any name/string just via the path to the image. Find a running instance here: https://labelgenerator.vspace.one/. Or the development branch here: https://dev.labelgenerator.vspace.one/.
Make requests to
GET http(s)://example.org/<labelname>/<your_name>.png
or
GET http(s)://example.org/<labelname>/<your_name>.jpeg
to receive the requested label as image.
In the following is describe how to install and run the LabelGenerator.
You got the following options:
- run as native Flask server
- run via commandline locally
- run as Docker Container
python -m venv .venv
source .venv/bin/activate
pip install opencv-python flask Flask-Caching
The Label Generator can be run as commandline tool. Execute:
source .venv/bin/activate
python src/CMDInterface.py -o <outputfile> -t <text> -l <label>
Alternative opts are -h for help and -v for version.
The more common use case is to run the Label Generator as a Webapplication. There for run the following:
source .venv/bin/activate
python src/Server.py -p <port> -i <hostip> -d <debug>
The default port is 5007, the default host ip is 0.0.0.0. Both can be overwritten via opts. The debug flag is either 1 or 0.
TODO: Alternative opts are -h for help and -v for version.
Beside running LabelGenerator locally you can deploy it as Docker Container. Therefore run the following:
docker build -t labelgenerator .
docker run -d -p 5007:5007 labelgenerator
We use gitflow for the development. So please use the branch names develop, feature/, ... and use PullRequests for your contributions.
Please find the licence here licence.