Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

GUI for Machine assisted Knitting.

Project Description

All Yarns Are Beautiful

This is the GUI interface for AYAB.




For Debian/Ubuntu

sudo apt-get install python-pip python-qt4 python-dev

For openSUSE

# openSUSE
sudo zypper install python-pip python-qt4 python-virtualenv

All Distributions

To be able to communicate with your Arduino, it might be necessary to add the rights for USB communication by adding your user to some groups.

sudo usermod -a -G tty [userName]
sudo usermod -a -G dialout [userName]


Create a virtual enviroment (e.g. in $HOME/ayab/) and install ayab with

virtualenv --system-site-packages venv/
source venv/bin/activate
pip install ayab

Start ayab with

Note: If running ayab fails with “IOError: [Errno 13] Permission denied: ‘/usr/local/lib/python2.7/dist-packages/oauthlib-0.6.0-py2.7.egg/EGG-INFO/top_level.txt” or similar, try to change the permissions of the file using
sudo chmod o+r /usr/local/lib/python2.7/dist-packages/oauthlib-0.6.0-py2.7.egg/EGG-INFO/top_level.txt


The Windows version which is available at has been packed with py2exe and should not require any additional dependencies. Just unzip the archive to C:ayab-windows-0.80 and start ayab.exe


To install the development version you can checkout the git repository. You need Python 2.7 and PyQt from your package manager’s repository. The other main dependencies are: Pillow >= 2.4, pyserial >= 2.7, fysom >= 1.1 and Yapsy >= 1.10 Move to the software/python/ folder and install the required dependencies.

Development Dependencies for Linux


Development Dependencies for Windows

Download and install Python 2.7.x from
Download and install pip from
Download and install PyQt4 from

Release Notes

0.80 (November 2015)


  • API v4
  • Added Test Mode
  • Added Auto-Init functionality
  • Added FW Version Define
  • Fixed reset of needles out of active needle area
  • Added support for I2C port expander on shield v1.3TH (MCP23008)


  • requires APIv4
  • Basic visualisation of pattern position
  • Mouse wheel zooming of pattern
  • Visualisation of Test Mode data
  • Auto-Init functionality (no need to click OK several times when starting to knit)
  • Firmware database moved to external JSON file
  • Fix pattern rotation direction
  • Fix pattern inversion
  • Fix growth of image when rotating
  • Fix unlocking of knit controls after image manipulation

0.75 (February 2015)


  • Fixed Lace carriage support

0.7 (February 2015)


  • Lace carriage support


  • Showing info about current line number
  • Some layout fixes (disabling UI elements, …)
  • Starting to knit with the bottom of the image
  • Fixed progressbar in 2 color doublebed mode
  • Start and Stop needle selection like on the machine (orange/green)
  • Infinite Repeat functionality
  • Cancel button added
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ayab-0.80.tar.gz (196.1 kB) Copy SHA256 Checksum SHA256 Source Dec 1, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting