Skip to content

Installation

System requirements

Requirement Minimum
OS Linux (x86_64 or aarch64)
Python 3.11 or later
pip 21.0+ (for editable installs)
Disk ~50 MB for Missy + dependencies

Linux only

Missy targets Linux as a first-class platform. macOS may work for development but is not tested or supported. Windows is not supported.

Check your Python version:

python3 --version  # (1)!
  1. Must print Python 3.11.x or later. On some distros, use python3.11 or python3.12 explicitly.

Install methods

The fastest way to install Missy, clone the repo and install in one step:

curl -fsSL https://raw.githubusercontent.com/MissyLabs/missy/master/install.sh | bash

This clones the repository, creates a virtual environment, installs Missy, and launches the setup wizard.

Clone the repository and install in development/editable mode:

git clone https://github.com/MissyLabs/missy.git
cd missy
pip install -e .

Recommended for keeping your system Python clean:

git clone https://github.com/MissyLabs/missy.git
cd missy
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Do not install as root

Missy stores configuration and data in ~/.missy/. Installing as root will place these files under /root/.missy/, which is rarely what you want.

Optional extras

Missy supports optional dependency groups for voice and observability features. Install them by appending the extra name in brackets:

Adds faster-whisper (STT), numpy, and soundfile for the voice channel:

pip install -e ".[voice]"

Note

Voice support also requires the Piper TTS binary, which is installed separately. See Voice Server Setup for details.

Adds the OpenTelemetry SDK and OTLP exporters (gRPC and HTTP):

pip install -e ".[otel]"

Adds pytest, ruff, mypy, and other development tools:

pip install -e ".[dev]"

Install all extras at once:

pip install -e ".[dev,voice,otel]"

Verify the installation

After installing, confirm that the missy CLI is available:

missy --help

You should see output listing all available commands. If the command is not found, ensure your virtual environment is activated or that the pip install location is on your PATH.

Next steps

Run the setup wizard to configure your first AI provider:

missy setup

See Quick Start for a walkthrough, or Setup Wizard for the full reference.