Skip to content

Installation

Ubuntu
  • Download the deb file from here
  • Navigate to the Downloaded deb file location, and install it. This also fetches dependencies : scipy, qtconsole, avr-gcc etc
    sudo apt install ./KuttyPy-1.0.25.deb 
    
  • launch the kuttyPy GUI from the command prompt using the command
    kuttypyplus
    

It is also present in the applications menu as KuttyPy GUI .

  • You can also launch the kuttyPy IDE from the menu, or using the command
    kuttypyide
    
Windows with Python3 installed PyPI version
  • Python3 must be installed, and pip should be accessible.
  • Open a command prompt as administrator, and use pip3 to install the KuttyPy package
    py -3 -m pip install KuttyPy
    
  • Download and install the CH341 USB Driver
  • You will now be able to launch kuttypyplus from the prompt, and import the kuttyPy library from any Python script.
  • you can also launch kuttypyide
  • If you wish to compile C code and upload to the KuttyPy hardware, winavr must be installed, and avr-gcc must be accessible from a command prompt.
  • if the commands are not accessible, then you need to add the Scripts folder to the path. similar docs here
Windows bundled installer
  • The bundled installer includes Python3 and dependencies and KuttyPy software. Also includes winavr, usb driver.

Download Bundled Installer

Made with Pyinstaller: Python will not be accessible globally

Since the installer was made using PyInstaller, Python3 will not be accessible globally, and you will be limited to the ipython console within the KuttyPy software. A better option would be to use pip to fetch PyQT5, qtconsole, pyserial, pyqtgraph, scipy , and KuttyPy . Winavr and the driver can be installed separately. Refer to the previous section.

Using Python PIP PyPI version Windows/Linux/Other OSes
  • Python3 must be installed
  • Open a command prompt as administrator, and use pip3 to install the KuttyPy package
    pip3 install kuttyPy
    
  • You will now be able to launch kuttypy from the prompt, and import the kuttyPy library from Python.
  • If you wish to compile C code, avr-gcc must be accessible from a command prompt. Install it from the package manager of your OS.
setting permissions on Linux based systems

Accessing the hardware on linux requires certain permissions to be set. Due to an apparent bug with pip3, the install script may fail to do this.

As a workaround, you can run the program as root to verify the permissions issue

sudo kuttypy
For a more permanent fix for regular users, please download and execute this post installation script

chmod +x postinst.sh
sudo ./postinst.sh
kuttypy
Installing from source code

sudo apt install python3-serial python3-pyqt5 python3-pyqt5.qtsvg gcc-avr avr-libc python3-qtconsole python3-scipy python3-pyqtgraph
git clone http://github.com/csparkresearch/kuttypy-gui
cd kuttypy-gui
python3 KuttyPyPlus.py
For setting hardware permissions, refer to the previous section

Android App Ubuntu package . Unrelated.

The device works with android phones via USB-OTG, but the app is structured very differently from the desktop setup, and these docs do not apply.

Install from the Google Play Store

Installing from the Ubuntu repository

Ubuntu package

this version may not be up to date because this is very recent work, and several changes were made over the past few months

  • sudo apt install kuttypy

License: MIT