Skip to main content

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

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
ayab-0.80.tar.gz (196.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page