View on GitHub


Test Coverage
.. _installation:

kniteditor Installation Instructions

This document aims at showing all the ways that the knit editor can be installed.


You can download the `latest installers
from the `github releases
This includes these binaries:

- Mac OSX App `"KnitEditor.dmg" <>`__
- Windows Installer `"KnitEditorInstaller.exe" <>`__
- Windows standalone `"" <>`__

All download locations are listed here:

- `AppVeyor <>`__
- `The Python Package Index <>`__
- `Github Releases <>`__

Kivy Installation

.. warning:: Kivy as of today, 2016/07/04, works for Python 3.4. If you intend to use an other version,
  be aware that it might take a lot of time.


1. If kivy does not work, uninstall kivy.

  .. code:: bash
      py -3.4 -m pip uninstall kivy

2. Uninstall Python 3.4. Unless you want to install Visual Studio and configure how to compile Python modules with the right compiler at the right location, you uninstall Python 3.4. All the installed packages wil be left untouched. This is why we uninstalled kivy before.

3. Use the `kivy installer <>`__ to install kivy. [`Thanks <>`__]


See the `kivy installation instructions <>`__.

Package installation from Pypi

The kniteditor library requires `Python 3 <>`__.
It can be installed form the `Python Package Index


Install it with a specific python version under windows:

.. code:: bash

    py -3 -m pip --no-cache-dir install --upgrade kniteditor

Test the installed version:

.. code:: bash

    py -3 -m pytest --pyargs kniteditor


To install the version from the python package index, you can use your terminal and execute this under Linux:

.. code:: shell
  sudo python3 -m pip --no-cache-dir install --upgrade kniteditor

test the installed version:

.. code:: shell
  python3 -m pytest --pyargs kniteditor

.. _installation-repository:

Installation from Repository

You can setup the development version under Windows and Linux using the
`source code repository <>`__.

.. _installation-repository-linux:


If you wish to get latest source version running, you can check out the repository and install it manually.

.. code:: bash

  git clone
  cd kniteditor
  sudo python3 -m pip install --upgrade pip
  sudo python3 -m pip install -r requirements.txt
  sudo python3 -m pip install -r test-requirements.txt
Errors? `JPEG <>`__

To also make it importable for other libraries, you can link it into the site-packages folder this way:

.. code:: bash

  sudo python3 link

.. _installation-repository-windows:


Same as under :ref:`installation-repository-linux` but you need to replace
``sudo python3`` with ``py -3``. This also counts for the following