Skip to main content

A very persuasive package, for creating embroidery patterns

Project description


A very persuasive package, for creating embroidery patterns.

As seen at PyCon US 2019


Requires Python 3.7+ and pip:

pip install ih

CLI Usage


  -p, --palette TEXT     Choices: lego, floss, perler, alpaca, wool. Default:
  -s, --scale INTEGER    Rescale factor. Default: 1
  -c, --colours INTEGER  Limit palette to at most N colors. Default: 256
  -r, --render           Render a preview (using thread images)
  -g, --guidelines       Render guidelines
  --help                 Show this message and exit.

Example usage:

ih -p alpaca -s 16 -r -c 4 demo_image.png

For the demo image (source, freetoedit) using the alpaca palette, and scaling the input image x16 smaller, render the result in up to 4 colours

Open demo_image.html to see the result.

sample render

As A Service

See ih-aas

Install from source

Using git and virtualenv:

git clone
cd ih
virtualenv venv
source venv/bin/activate
pip install -r requirements

Package name origin

Disney's Lilo and Stitch:

Jumba: What?! After all you put me through you expect me to help you just like that?! Just like that?!
Stitch: Ih.
Jumba: Fine.
Pleakley: Fine? You're doing what he says?
Jumba: Uh, he's very persuasive.


LILO & STITCH is a trademark of Disney Enterprises, Inc.

LEGO® is a registered trademark of The Lego Group.

PERLER BEADS is a trademark of Stitch Acquisition Group.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ih, version 0.0.0.dev25
Filename, size File type Python version Upload date Hashes
Filename, size ih-0.0.0.dev25.tar.gz (67.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page