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.

Source Distribution

ayab-0.80.tar.gz (196.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page