abraia 0.3.4

Abraia Python SDK

Abraia API client for Python

Python client for the Abraia API, used to smartly transform and optimize (compress) images on-line. Read more at https://abraia.me/docs.

Optimize images for Web with no quality damage based on perception-driven technology.

• Optimal image compression with our perceptual adjustment to preserve the quality and maximize the compression.
• Smart crop and resize images with our saliency and aesthetic based model which balances between content and aesthetics.

abraia optimize --width 800 --height 400 https://images.pexels.com/photos/700948/pexels-photo-700948.jpeg images/skater.jpg

The example takes a 10.1MB image by Willian Was from Pexels with a size of 4865x3321 pixels and automatically generates a 94.4kB header of 800x400 pixels, cropping, resizing, and optimizing the image to directly be used on Web.

Installation

The Abraia python client works in Windows, Mac, and Linux with Python 2 and 3 (python>=2.6.5).

Install the API client and the CLI with a simple command:

pip install -U abraia

Verify that the abraia CLI is correctly installed:

abraia --version

Configuration

For configuration you just need to create a free account and introduce the API KEYS using the command bellow:

abraia configure

Usage

API usage:

Abraia API makes easy to compress and transform images. You just need to define the source of the image, the transformation operation, and the sink for the resultant image.

import abraia

abraia.from_file('images/lion.jpg').resize(
    width=600, height=600).to_file('images/lion_600x600.jpg')

abraia.from_url('https://abraia.me/images/random.jpg').resize(
    height=400).to_file('images/random_x400.jpg')

abraia.from_store('demo/birds.jpg').to_file('images/birds.jpg')

CLI usage:

With the CLI tool you can compress and optimize all the images in a folder with a simple command:

abraia optimize images

Or you can resize and automatically crop all your images and folders, just adding the image size parameters:

abraia optimize --width 500 images/lion.jpg images/resized.jpg
abraia optimize --width 333 --height 333 images/lion.jpg images/cropped.jpg

License

This software is licensed under the MIT License. View the license.