Sinapsis Image Transforms

Templates for applying image transformations using Albumentations.

🐍 Installation • 📦 Packages • 🌐 Webapp • 📙 Documentation • 🔍 License

This mono repo contains the sinapsis-albumentations package, featuring an extensive collection of templates for image transformation supported by the Albumentations library.

🐍 Installation

Install using your package manager of choice. We encourage the use of uv

Example with uv:

  uv pip install sinapsis-albumentations --extra-index-url https://pypi.sinapsis.tech

or with raw pip:

  pip install sinapsis-albumentations --extra-index-url https://pypi.sinapsis.tech

📦 Packages

Sinapsis albumentations

The Sinapsis Albumentations package provides a collection of templates for applying image transformations using Albumentations.

For specific instructions and further details, see the sinapsis-albumentations README.

🌐 Webapp

The webapp provides an interactive interface to visualize and experiment with image transformations in real time.

Important

To run the app you first need to clone this repository:

git clone git@github.com:Sinapsis-ai/sinapsis-image-transforms.git
cd sinapsis-image-transforms

Note

If you'd like to enable external app sharing in Gradio, export GRADIO_SHARE_APP=True

🐳 Docker

1. Build the sinapsis-image-transforms image:

docker compose -f docker/compose.yaml build

2. Start the app container:

docker compose -f docker/compose_apps.yaml up sinapsis-albumentations-gradio -d

3. Check the status:

docker logs -f sinapsis-albumentations-inference-gradio

3. The logs will display the URL to access the webapp, e.g.:

NOTE: The url can be different, check the output of logs

Running on local URL:  http://127.0.0.1:7860

4. To stop the app:

docker compose -f docker/compose_apps.yaml down

💻 UV

To run the webapp using the uv package manager, please:

1. Create the virtual environment and sync the dependencies:

uv sync --frozen

2. Install the wheel:

uv pip install sinapsis-image-transforms[all] --extra-index-url https://pypi.sinapsis.tech

3. Run the webapp:

uv run webapps/gradio_albumentations_transforms_visualizer.py

4. The terminal will display the URL to access the webapp, e.g.:

NOTE: The url can be different, check the output of the terminal

Running on local URL:  http://127.0.0.1:7860

📙 Documentation

Documentation for this and other sinapsis packages is available on the sinapsis website

Tutorials for different projects within sinapsis are available at sinapsis tutorials page

🔍 License

This project is licensed under the AGPLv3 license, which encourages open collaboration and sharing. For more details, please refer to the LICENSE file.

For commercial use, please refer to our official Sinapsis website for information on obtaining a commercial license.