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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.