Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.2rc1

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.2rc1
File Size Uploaded Provenance Actions
localm-0.3.2rc1.tar.gz 21.2 MB With provenance Details for localm-0.3.2rc1.tar.gz

Built distribution (wheel)

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

Total release size: 37.4 MB

Release files / localm-0.3.2rc1.tar.gz

Download URL localm-0.3.2rc1.tar.gz
Size 21.2 MB
Tags Source
SHA-256 checksum
How to use checksums
5a9064dbb1372e5e6b309cd917dc7a1956127bf10951f0cc4e3fc564b2ed47f6
BLAKE2b-256 checksum
How to use checksums
a49224e7c245a58496d10a6acbe4e84b72de59ec5304fb90baac7fb1b073fa30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 27, 2026.

Transparency log

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

Download URL localm-0.3.2rc1-py3-none-any.whl
Size 16.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
3edfa398eee2ff0b9bf3579ff10b4578ee3c4497cceb9b037e201e8259f095f8
BLAKE2b-256 checksum
How to use checksums
5bd2b569c262e6225d1e1574ea6f2c0019ad477f91fb052b660db52d3f71d5d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 27, 2026.

Transparency log

Security for localm 0.3.2rc1

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.2rc1.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 27, 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