Before you start building apps with Kivy you will need to have a working installation of Kivy on your system. If you don't have it set up yet, the following steps will guide you through how to install Kivy on Windows, macOS or Linux.
If you don't have an installation of Python 3, you will need to install one first. You can download installers for Python 3 from the Python homepage. Once installed, you should be able to follow the instructions below.
Set Up Your Project Environment & Install Kivy
To keep your projects self-contained, we recommend creating a new virtual environment for each project. Using virtual environments ensures that Kivy and its dependencies don't interfere with other Python projects on your system. If you're just learning, you can create a single virtual environment for working through the tutorials.
If you later want to create a new folder for a different project, you can just repeat this process.
Below are the instructions for creating a new project folder, setting up a Python virtual environment and installing Kivy on Windows, macOS and Linux.
Install Kivy on Windows
```cmd:Windows
mkdir myapp/ cd myapp python -m venv venv venv\Scripts\activate.bat (venv)> pip install kivy
PyQt/PySide Development Services — Stuck in development hell? I'll help you get your project focused, finished and released. Benefit from years of practical experience releasing software with Python.
### Install Kivy on macOS
```sh:macOS
$ mkdir myapp/
$ cd myapp
$ python -m venv venv
$ source venv/bin/activate
(venv)$ pip install kivy
Install Kivy on Linux
```sh:Linux $ mkdir myapp/ $ cd myapp $ python -m venv venv $ source venv/bin/activate (venv)$ pip install kivy
## Verify Your Kivy Installation
Once the installation is complete, start Python by running `python` from the command line. You should then be able to import Kivy with the following command:
```python
import kivy
If that import works without errors, Kivy is correctly installed and you're now ready to start building Python GUI applications with Kivy. To get started, check out our Kivy Basic Tutorial which walks you through creating your first app.
PyQt/PySide Office Hours 1:1 with Martin Fitzpatrick — Save yourself time and frustration. Get one on one help with your projects. Bring issues, bugs and questions about usability to architecture and maintainability, and leave with solutions.
