File size: 2,049 Bytes
28da246
2676f3e
60d9a77
2676f3e
60d9a77
 
 
2676f3e
60d9a77
2676f3e
60d9a77
2676f3e
 
 
 
60d9a77
 
 
96a96d9
 
 
 
 
60d9a77
 
 
 
 
 
2676f3e
60d9a77
2676f3e
60d9a77
bfcdf29
60d9a77
 
 
 
 
 
da5c717
bfcdf29
 
60d9a77
 
 
96a96d9
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# albumentations-demo

This service is created to demonstrate abilities of the [Albumentations](https://github.com/albumentations-team/albumentations) - a library for efficient image augmentations.

## Easy start
You can play with this service right now [https://albumentations-demo.herokuapp.com/](https://albumentations-demo.herokuapp.com/)
(It is deployed on free service with very limited computing power and can be quite unstable)

If you would like to run it locally follow the installation instruction.

## Installation
```
git clone https://github.com/IliaLarchenko/albumentations-demo
cd albumentations-demo
pip install -r requirements.txt
streamlit run src/app.py
```

If you want to work with you own images just replace the last line with:
```
streamlit run src/app.py -- --images_folder PATH_TO_YOUR_IMAGE_FOLDER
```

In your terminal you will see the link to the running local service similar to : 
```console
  You can now view your Streamlit app in your browser.

  Network URL: http://YOUR_LOCAL_IP:8501
  External URL: http://YOUR_GLOBAL_IP:8501
```
Just follow the local link to use the service.

## How to use

The interface is very simple and intuitive:
1. On the left you have a control sidebar. You can choose the image and the transformation.
2. After that you will see the control elements for the every parameter this transformation has.
3. Every time you change any parameter you will see the augmented version of the image on the right side of your screen.
4. Below the images you can find a code for calling of the augmentation with selected parameters.
5. You can also find there the original docstring for this transformation.
![screenshot](docs/screenshot.jpg?raw=true)


## Links
* Albumentations library: [github.com/albumentations-team/albumentations](https://github.com/albumentations-team/albumentations)
* Image Source: [pexels.com/royalty-free-images](https://pexels.com/royalty-free-images/)
* Streamlit - framework powering this app [github.com/streamlit/streamlit](https://github.com/streamlit/streamlit)