meshtastic/docs/software/python-cli/installation.mdx

---
id: installation
title: Meshtastic Python CLI installation
sidebar_label: Installation
slug: /software/python/cli/installation
sidebar_position: 1
description: This page offers comprehensive instructions on methods of installing the Meshtastic Python CLI across different operating systems. 
---

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";

## Meshtastic Python Library

This library provides a command-line interface (CLI) for managing the user settings of Meshtastic nodes and provides an easy API for sending and receiving messages over mesh radios. Events are delivered using a publish-subscribe model, and you can subscribe to only the message types you are interested in.

The [Meshtastic-python repo](https://github.com/meshtastic/Meshtastic-python) and [API documentation](https://python.meshtastic.org) are excellent sources of information. If you wish to view the code or contribute to the development of the Python library or the command-line interface, please visit the Meshtastic Python [GitHub page](https://github.com/meshtastic/Meshtastic-python).

### Installation Methods

You can install the Meshtastic CLI using one of the following methods:

1. **Python Package Installer (pip)**: Installation can be easily done through the [Python package installer pip](https://pypi.org/project/meshtastic). Make sure to use pip version 20 or later by running `pip install --upgrade pip` if necessary.
2. **Standalone Executable (Ubuntu only)**: A single executable file for Ubuntu is available on the [Releases](https://github.com/meshtastic/Meshtastic-python/releases) page. See [Standalone](#standalone-installation-ubuntu-only) below for instructions.

### Prerequisites

Before installing, ensure that your system meets the following requirements:

- **Serial Drivers**: Your computer should have the required serial drivers installed for the [CP210X USB to UART bridge](https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers) or the [CH9102](http://www.wch.cn/downloads/CH343SER_ZIP.html) (for some newer boards).
- **Python**: Python 3 should be installed on your system. Check with `python3 -V` and install it if necessary.
- **pip**: The Python package installer pip should be installed. Check with `pip3 -V` and install it if necessary.

After ensuring the requirements are met, follow the installation instructions for your operating system in the tabbed section below.


<Tabs
groupId="operating-system"
queryString="install-python-cli"
defaultValue="windows"
values={[
{label: 'Linux', value: 'linux'},
{label: 'macOS', value: 'macos'},
{label: 'Windows', value: 'windows'},
{label: 'Termux for Android', value: 'termux'},
]}>
<TabItem value="linux">

#### Linux

- Check that your computer has the required serial drivers installed

  - Connect your Meshtastic device to your USB port
  - Use the command
    ```shell
    lsusb
    ```
  - You should see something like:
    - `ID 10c4:ea60 Silicon Labs CP210x UART Bridge` for CP210X
    - `ID 1a86:55d4 QinHeng Electronics USB Single Serial` for CH9102

- Check that your computer has Python 3 installed.

  - Use the command
    ```shell
    python3 -V
    ```
  - If this does not return a version, install python
    ```shell
    sudo apt-get update
    sudo apt-get install python3
    ```

- Pip is typically installed if you are using python 3 version >= 3.4

  - Check that pip is installed using this command
    ```shell
    pip3 -V
    ```
  - If this does not return a version, install pip
    ```shell
    sudo apt-get install python3-pip
    ```

- Optional: use a python virtual environment (otherwise jump to step "Install pytap2")
  - Install python-virtualenvwrapper (arch based distros as an example)
    ```shell
    sudo pacman -Syu python-virtualenvwrapper
    ```
  - Create a virtual environment
    ```shell
    source /usr/bin/virtualenvwrapper.sh
    mkvirtualenv meshtastic
    workon meshtastic
    ```
- Install pytap2
  ```shell
  pip3 install --upgrade pytap2
  ```
- Install meshtastic:
  ```shell
  pip3 install --upgrade meshtastic
  ```

</TabItem>
<TabItem value="macos">

#### macOS

- Check that your computer has the required serial drivers installed
  - Connect your Meshtastic device to your USB port
  - Navigate to `Apple Menu  > About This Mac > System Report... > Hardware > USB`
  - You should see something like `CP210X USB to UART Bridge Controller`
  - If not download the drivers from [Silicon Labs](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers).
- Check that your computer has Python 3 installed.
  - Use the command
    ```shell
    python3 -V
    ```
  - If this does not return a version, install [python](https://www.python.org)
    - The following uses Homebrew to install `python3` which includes `pip3`.
    - Check if you have Homebrew installed with the following command
      ```shell
      brew -v
      ```
      If it's not installed, follow the instructions on the [Homebrew website](https://brew.sh) before continuing.
    - Install Python3
      ```shell
      brew install python3
      ```
- Pip is typically installed if you are using python 3 version >= 3.4

  - Check that pip is installed using this command
    ```shell
    pip3 -V
    ```
  - If this does not return a version, install [pip](https://pip.pypa.io/en/stable/installing)

- Install pytap2
  ```shell
  sudo pip3 install --upgrade pytap2
  ```
- Install meshtastic:
  ```shell
  sudo pip3 install --upgrade meshtastic
  ```

</TabItem>
<TabItem value="windows">

#### Windows

- Check that your computer has the required serial drivers installed
  - Connect your Meshtastic device to your USB port
  - Open Device Manager
  - Under `Ports (COM & LPT)` you should see something like `Silicon Labs CP210X USB to UART Bridge (COM5)`
  - If not download the drivers from [Silicon Labs](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers) or use the direct link below.
    :::warning
    You must install the [CP210x Universal Windows Driver](https://www.silabs.com/documents/public/software/CP210x_Universal_Windows_Driver.zip). If you do not install this driver, your device may not work and the driver may need to be uninstalled from device manager before installing the correct driver.
    :::
- Check that your computer has Python 3 installed.
  - Use the command
    ```powershell
    py -V
    ```
  - If this does not return a version, install [python](https://www.python.org)
- Pip is typically installed if you are using python 3 version >= 3.4
  - Check that pip is installed using this command
    ```powershell
    pip3 -V
    ```
  - If this does not return a version, install [pip](https://pip.pypa.io/en/stable/installing)
- Install pytap2
  ```powershell
  pip3 install --upgrade pytap2
  ```
- Install meshtastic:
  ```powershell
  pip3 install --upgrade meshtastic
  ```

</TabItem>
<TabItem value="termux">

#### Termux

:::note
Wifi connection is currently under development and may not be working properly just yet. If you would like to provide feedback or test this feature, please visit our [forum](https://meshtastic.discourse.group) or join our [Discord server](https://discord.gg/ktMAKGBnBs) for more information.
:::

- Install [Termux](https://f-droid.org/en/packages/com.termux) from the F-Droid app store (Google play does not currently support the latest builds)
- Load Termux and update the package list
  ```shell
  pkg update
  ```
- Upgrade the installed packages
  ```shell
  pkg upgrade
  ```
- Install python
  ```shell
  pkg install python
  ```
- Upgrade pip and installed meshtastic and some of its dependencies
  ```shell
  pip install --upgrade pip pygatt pytap2 wheel meshtastic
  ```

:::note
Be aware that the Meshtastic CLI is not able to control the nodes over USB through termux, but you can control devices over Wifi using the `--host x.x.x.x` option with the device IP address. However, only ESP32 devices can use Wifi currently.
:::

</TabItem>
</Tabs>

:::info
You may need to close and re-open the CLI. The path variables may or may not update for the current session when installing.
:::

### Standalone Installation (Ubuntu only)

1. Download the `meshtastic_ubuntu` executable from the [Releases](https://github.com/meshtastic/Meshtastic-python/releases) page.
2. Run the following command to make the file executable and rename it `meshtastic`:

```shell
chmod +x meshtastic_ubuntu && mv meshtastic_ubuntu meshtastic
```
3. To run the CLI:

```shell
./meshtastic
```

:::tip
Copy (or move) this binary somewhere in your path.
:::