Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ recompiling. A breaking change waits for 2.0. (Before RC.1, `1.0.0-beta.N` and e
beta.4 → RC.1 changes that can break a build are listed under *Changed — breaking (pre-GA)* in the
RC.1 entry, and each entry's own "Beta caveats" apply to the betas.)

## 1.0.0 — GA (unreleased)
## 1.0.0 — GA — 2026-09-27

Fixes only; no API change.

Expand Down
27 changes: 18 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,15 @@
# LocalLM Lab

**LocalLM Lab** is a macOS app (macOS 26+, Apple Silicon, Apple Intelligence
enabled) that turns your Mac into a private chatbot with an OpenAI-compatible
API — fully offline with Apple's on-device model or open-weight models you
download and run locally, or pointed at a hosted provider when you want one —
and gives other apps and scripts a way to call whichever model you've picked.
**LocalLM Lab** is about running AI **on your own Mac** instead of renting it
from a hosted provider — no per-token bill, no data leaving your machine, no
dependency on someone else's uptime. It ships two ways to get there: an app,
and an SDK.

The **app** (macOS 26+, Apple Silicon, Apple Intelligence enabled) turns your
Mac into a private chatbot with an OpenAI-compatible API — fully offline with
Apple's on-device model or open-weight models you download and run locally,
or pointed at a hosted provider when you want one — and gives other apps and
scripts a way to call whichever model you've picked.

It's a single Dock app with five panels:

Expand All @@ -26,16 +31,20 @@ It began local-only — hence the name — and 1.0 added the hosted providers be
the same interface, so "local" is now the default rather than the only option.
On macOS 26 only Apple's on-device model runs; open-weight (MLX) models and the
hosted providers need macOS 27. **Private Cloud Compute** is wired up but needs
an Apple entitlement that is still pending, so it is inert in this beta.
an Apple entitlement that is still pending, so it is currently inert.

**Product page:** [thisbrain.ai/locallm](https://thisbrain.ai/locallm) — or
get the app directly:
[LocalLM Lab 1.0.0-GA (arm64 DMG)](https://github.com/ancientcomputing/locallm/releases/download/v1.0.0-GA/LocalLM.Lab-1.0.0-GA-arm64.dmg).

## LocalLM Lab SDK

The engine LocalLM Lab runs on is also published as an SDK — binary xcframeworks
you link into your own native macOS app. `LocalLMLabSDKCore` carries the
The **SDK** is the same engine LocalLM Lab runs on, published as binary
xcframeworks you link into your own native macOS app — so *your* app can run
local AI (Apple's on-device model, or an open-weight model you ship or let the
user download) instead of routing every request through a paid host API,
with hosted providers still available behind the same interface for when you
want one. `LocalLMLabSDKCore` carries the
connectors, a full MCP client, Core's Workspace (filesystem) tools, and the 1.0
model layer — routing and residency across every provider behind one API, with
`SystemModelProvider` (Apple on-device) built in. Add the provider modules you
Expand Down Expand Up @@ -77,7 +86,7 @@ what's public here is:

## Building on the SDK

> **1.0.0-beta — the model layer builds for macOS 26 & 27.** `SystemModelProvider` works on
> **The model layer builds for macOS 26 & 27.** `SystemModelProvider` works on
> macOS 26; MLX, `ClaudeForFoundationModels`, the hosted providers, and Private Cloud Compute
> need macOS 27. Coming from `0.8.x`? See
> **[docs/migrating-to-1.0.md](docs/migrating-to-1.0.md)** — it's mostly additive, with one
Expand Down
Loading