Abraia Python SDK
Project description
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
Finally, configure your API Keys using the command bellow:
abraia configure
You can create a free account to get your API Keys.
Command line interface
With the CLI tool you can optimize and resize images by batches.
You can easily compress a folder of images with a simple command:
abraia optimize images
To resize an image you just need to specify the width
or the height
of
the image:
abraia optimize --width 500 images/lion.jpg images/resized.jpg
To automatically crop and resize
specify both the width
and height
size parameters:
abraia optimize --width 333 --height 333 images/lion.jpg images/cropped.jpg
To filter and image specify some of the available filters:
abraia optimize --width 333 --height 333 --filter desaturate images/lion.jpg images/filtered.jpg
Fluent API
Abraia fluent API is the easiest way to compress and transform images with python. 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/bird.jpeg').resize(
width=375, height=375).to_file('images/bird_375x375.jpg')
abraia.from_url('https://api.abraia.me/files/demo/birds.jpg').resize(
width=750).to_file('images/birds_750.jpg')
abraia.from_store('demo/birds.jpg').resize(
width=375, height=375).to_file('images/birds_375x375.jpg')
Smart cropped image examples
All the operation parameters are automatically chosen to provide the best results balancing quality and file size for a perfectly responsive website.
PNG images can significantly optimized also.
Original PNG image (45KB) vs optimized PNG image (15.8KB)
License
This software is licensed under the MIT License. View the license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for abraia-0.3.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4eda4509b5187b99a02e39e51c8f029917264831e0c7da3930091e7c6242428f |
|
MD5 | a8f9ae5eef38d3ff367c4e2d95174ac2 |
|
BLAKE2b-256 | 9805de468ca80644f721cca2365539a6350d5a6d2d40e9c1da3af6c07871d961 |