Install LLMind
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 or uv (either works)
poppler-utilson the system if you'll enrich PDFs (brew install poppleron macOS,apt install poppler-utilson Debian/Ubuntu). Image and audio support work out of the box.
Install with pipx
The canonical install. pipx installs the CLI in its own virtualenv and exposes
the llmind command on your PATH:
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 viafaster-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. Get pipx with
brew install pipx && pipx ensurepath, or uv with
brew install uv.
Linux
Works on any Linux with Python 3.11+. Most distributions ship pipx in their
package manager (apt install pipx on Debian/Ubuntu,
dnf install pipx on Fedora). 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 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.
"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 — overview of LLMind
Next steps
- Quickstart — enrich your first file in 5 minutes
- CLI reference — learn all available commands and flags
- Claude Desktop MCP — integrate enriched files with Claude