Awesome Open Source
Awesome Open Source


chat build status code coverage code style styled with prettier made with lass license

Lipo is a free image manipulation API service built on top of Sharp
Need an alternative to Jimp, Graphics Magick, ImageMagick, or PhantomJS? • Built by @niftylettuce and contributors

Lipo is a cross-platform and drop-in replacement for Sharp

Table of Contents



npm install lipo


yarn add lipo


To keep things simple you can use the exact same API that Sharp offers.

const lipo = require('lipo');
 .resize(300, 300)
 .toFile('output.jpg', err => {
   if (err) throw err;
   console.log('resized image');

Lipo is a drop-in replacement for Sharp (so you won't have to worry about cross-platform installation).

You can simply replace instances of sharp with lipo:

-const sharp = require('sharp');
+const lipo = require('lipo');
  .resize(300, 200)
  .toFile('output.jpg', err => {
     if (err) throw err;
     console.log('resized image');

You can even use Lipo from the command line:

curl -F "[email protected]/Users/me/Desktop/input.jpg" \
  -F 'queue=[ [ "resize", 300, 300 ] ]' \
  -o /Users/me/Desktop/output.jpg \

Resize Method Options: If you need to use constant values such as sharp.kernel.nearest, sharp.gravity.centre, or any other option from resize, please use the alternate form of Lipo.kernel.nearest and Lipo.gravity.centre, respectively (just as an example)

Rate Limiting

Note that if you use make more than 100 requests per hour from the same IP address or wish to exceed 20MB file upload size limitation, we will rate limit you until you sign up for an API key at

Once you sign up for a key, you can pass it as const lipo = require('lipo')({ key: 'YOUR_API_KEY_HERE' }); or as an environment variable (e.g. LIPO_KEY=YOUR_API_KEY_HERE node app.js).


While building Lad I was instructing our team how to install Sharp, but there was a lot of confusion with libvips and many cross-platform installation issues.

Between Docker, Ubuntu, and Mac cross-platform issues reported by the team, I wanted to drop Sharp completely as a dependency from Lad.

I tried pure JavaScript-based solutions like Jimp, and even tried PhantomJS and Puppeteer solutions, however they were all too slow.

Sharp was the fastest option, and therefore I thought making a drop-in replacement that uses a powerful server would be satisfactory.

Thus Lipo was born.

Deploy Yourself

See the test folder for an example that shows how to use the middleware lipo-koa (also see lipo-express and other related packages below).



Lips by Orin zuu from the Noun Project


Name Website
Nick Baugh
Imed Jaberi

Trademark Notice

Lipo, Lass, Lad, Cabin, and their respective logos are trademarks of Niftylettuce LLC. These trademarks may not be reproduced, distributed, transmitted, or otherwise used, except with the prior written permission of Niftylettuce LLC. If you are seeking permission to use these trademarks, then please contact us.


MIT © Nick Baugh


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (70,958
nodejs (3,869
node (1,020
image (508
graphics (438
crop (81
scale (71
resize (51
magic (49
auto (36
manipulation (30