---
title: "Install LLMind — pipx, uv, development | LLMind"
description: "Install LLMind via pipx or uv from PyPI. Requires Python 3.11+. Guides for macOS and Linux. Dev install for contributors."
url: https://llmind.org/docs/install/
source_format: html
---
# Install LLMind

Published 2026-04-22 · 4 min read

LLMind ships as a Python package on PyPI. Install it with `pipx` or `uv` — both put the CLI on your `PATH` in an isolated environment without touching your system Python.

## System requirements

-   macOS or Linux
-   Python 3.11 or newer
-   [pipx](https://pipx.pypa.io/) or [uv](https://docs.astral.sh/uv/) (either works — see below)
-   `poppler-utils` on the system if you'll enrich PDFs (`brew install poppler` on macOS, `apt install poppler-utils` on Debian/Ubuntu). Image and audio support work out of the box.

## Install pipx

LLMind installs through `pipx`, which puts the CLI in an isolated virtualenv and exposes `llmind` on your `PATH` without touching system Python. If you already have `pipx` (or prefer `uv`), skip to [Install LLMind with pipx](#install-llmind-with-pipx).

### macOS

```
brew install pipx
pipx ensurepath
```

Open a new terminal afterward so the updated `PATH` takes effect.

### Linux

Most distributions ship `pipx` in their package manager:

```
# Debian / Ubuntu
sudo apt install pipx
pipx ensurepath

# Fedora
sudo dnf install pipx
pipx ensurepath
```

On distros without a packaged `pipx`, install via the official Python package:

```
python3 -m pip install --user pipx
python3 -m pipx ensurepath
```

### Prefer uv?

`uv` works as a drop-in alternative. Install it with `brew install uv` on macOS or follow the [official uv install guide](https://docs.astral.sh/uv/getting-started/installation/) on Linux. Then jump to [Install with uv](#install-with-uv).

## Install LLMind with pipx

With `pipx` ready, install the CLI:

```
pipx install 'llmind-cli[all]'
llmind --version
```

`[all]` bundles every supported provider. If you only need one and want a smaller install, pick the matching extra instead:

-   `[all]` — every provider below (recommended default)
-   `[anthropic]` — Claude vision only
-   `[openai]` — GPT-4o vision + Whisper transcription
-   `[gemini]` — Gemini 2.0 vision + audio
-   `[whisper-local]` — offline Whisper via `faster-whisper`
-   `[embeddings]` — VoyageAI embeddings for semantic search

Combine extras with commas: `pipx install 'llmind-cli[anthropic,whisper-local]'`.

## Install with uv

If you already use `uv` for Python tooling, the install is identical:

```
uv tool install 'llmind-cli[all]'
```

## Verify the install

After installation, verify the tool is available:

```
llmind --version
```

You should see version `0.1.0`. If the command is not found, run `pipx ensurepath` (or `uv tool update-shell`) and open a new terminal.

## Platform-specific notes

### macOS

Works on Apple Silicon and Intel. See [Install pipx](#install-pipx) above for the canonical macOS path via Homebrew.

### Linux

Works on any Linux with Python 3.11+. See [Install pipx](#install-pipx) above for per-distro commands. For PDF support, also install `poppler-utils`.

### Windows

Use WSL (Windows Subsystem for Linux) and follow the Linux instructions above. Native Windows is not currently tested.

## Development install

If you're contributing to LLMind, clone the [repository](https://github.com/dmitryrollins/LLMind) and run an editable install from the `llmind-cli/` directory:

```
cd llmind-cli
pip install -e '.[all,dev]'
```

## Troubleshooting

### "llmind: command not found"

The pipx/uv binary directory isn't on your `PATH` yet. Run `pipx ensurepath` (or `uv tool update-shell`), then close and reopen your terminal.

### "No matching distribution found for llmind-cli"

Your Python version is older than 3.11. Check with `python3 --version`. On macOS, install a newer Python with `brew install python@3.12`. On Linux, use your distribution's Python 3.11+ package or [pyenv](https://github.com/pyenv/pyenv).

### "Unable to get page for poppler" or PDF errors

`pdf2image` needs the `poppler-utils` system package. Install it with `brew install poppler` on macOS or `apt install poppler-utils` on Debian/Ubuntu, then retry your enrich command.

## Explore

-   [Product](https://llmind.org/product/) — overview of LLMind

## Next steps

-   [Quickstart](https://llmind.org/docs/quickstart/) — enrich your first file in 5 minutes
-   [CLI reference](https://llmind.org/docs/cli/) — learn all available commands and flags
-   [Claude Desktop MCP](https://llmind.org/mcp/claude-desktop/) — integrate enriched files with Claude