Skip to main content

LocaLM

Run large language models on your own machine. Offline, private, and yours.

LocaLM downloads and runs LLMs locally: GGUF models through llama.cpp and HuggingFace models through transformers, on AMD, NVIDIA, Intel, Apple Silicon (experimental) or CPU. It ships a chat GUI, an OpenAI-compatible API, a coding agent, RAG over your own documents, and an MCP server, with every online feature off by default. The only thing it does online without being asked is a periodic update check (see Network below), which you can turn off too.

Install

pip install localm
localm setup-llama

setup-llama detects your GPU and provisions the matching llama.cpp runtime: NVIDIA gets a self-contained CUDA build (no CUDA Toolkit needed), AMD RX 6000 on Windows a bundled ROCm build, other AMD GPUs the ROCm/HIP build when a system ROCm/HIP toolkit is installed (Vulkan otherwise), Intel on Windows a self-contained SYCL build, Intel on Linux a Vulkan build, Apple Silicon Metal (experimental), and no GPU the CPU build. localm setup-llama --backend <name> picks one yourself.

Then pull a model and talk to it:

localm pull unsloth/Qwen3-4B-Instruct-2507-GGUF:Qwen3-4B-Instruct-2507-Q4_K_M.gguf
localm run Qwen3-4B-Instruct-2507-Q4_K_M

Or open the graphical interface:

localm gui

Python 3.12 is required (the package supports 3.12.x only, not 3.13 or newer). localm doctor reports what is installed and what is missing at any point.

Where data lives

Set LOCALM_HOME to choose where models, chats and settings are stored. Left unset, it defaults to a directory inside the Python environment you installed into (not a per-user directory); localm info prints the path actually in use.

Network

Online features (web access for the coder, cloud model providers) are opt-in. The one request LocaLM makes on its own is a periodic check for a new release, which sends no version number or chat content - turn it off with localm config net_mode off, or clear the update endpoint. Details: https://github.com/Matlan1/localm/blob/master/docs/privacy.md#4-update-checks-network-policy-not-a-persistence-mode

The self-contained installer

The pip package installs LocaLM into an environment you already manage. The installer on GitHub instead provisions its own Python and its own private environment, adds a desktop launcher and a native app window, and walks you through choosing plugins. If you would rather have that, or you are not on Python 3.12, use it:

https://github.com/Matlan1/localm

Documentation, issues and source

https://github.com/Matlan1/localm

AGPL-3.0-or-later.

Metadata

Release files for localm 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for localm 0.3.2
File Size Uploaded Provenance Actions
localm-0.3.2.tar.gz 21.4 MB With provenance Details for localm-0.3.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for localm 0.3.2
File Interpreter ABI Platform Actions
localm-0.3.2-py3-none-any.whl Python 3 none any Details for localm-0.3.2-py3-none-any.whl

Total release size: 37.7 MB

Release files / localm-0.3.2.tar.gz

Download URL localm-0.3.2.tar.gz
Size 21.4 MB
Tags Source
SHA-256 checksum
How to use checksums
c08edc1e3e70e30b111b6af3ef66dc84a3d7ecadb4589556578cadc0dcc14062
BLAKE2b-256 checksum
How to use checksums
f76846cbb826693e4932a1cc322c7a968116925973e6390f08ce88a992592f5a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / localm-0.3.2-py3-none-any.whl

Download URL localm-0.3.2-py3-none-any.whl
Size 16.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
8eba17a1bf0a0377a62936ec914a03893a0968e90008bcc0dae9ed34aeadac61
BLAKE2b-256 checksum
How to use checksums
14660b8af49a296e89c57ea34f04858979fd51ca53de2d667b97b1be345b4f40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for localm 0.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for localm-0.3.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page