Read-only mirror of the public Private Local Chat repository on GitHub.
  • JavaScript 91.4%
  • CSS 3.8%
  • HTML 2.8%
  • Python 1.9%
Find a file
John Benac 980d88640c docs(evidence): record the clean-machine check on the published v0.78.0 archives
The delivery tooling's 1.6.0 check, run on the two zips as downloaded from the release, with a
serve command per target. Unpack, scan, attribution and a loopback serve all pass. The limits
are in the record; the independent check is taskboard's.
2026-11-18 21:58:29 -05:00
.agents/skills docs(agents): update the privatelocalchat instructions and skills 2026-11-18 19:31:31 -05:00
.claude/skills docs(agents): update the privatelocalchat instructions and skills 2026-11-18 19:31:31 -05:00
.github fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
brand fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
chat chore(neutral): reword comments that named internal paths, machines, agent files and board ids 2026-11-18 15:43:32 -05:00
content fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
dev-tools refactor(ops): delete the old publishers, keep only PLC's pin data 2026-11-17 22:18:35 -05:00
docs docs(evidence): record the clean-machine check on the published v0.78.0 archives 2026-11-18 21:58:29 -05:00
ops refactor(runtime): keep the pinned runtime manifest inside runtime/providers 2026-11-17 22:39:09 -05:00
run-kit feat(delivery): use the shared scan and say in every build where it came from 2026-11-18 16:11:45 -05:00
runtime chore(neutral): reword comments that named internal paths, machines, agent files and board ids 2026-11-18 15:43:32 -05:00
scripts docs(self-hosting): add the one-page self-hosting document and ship it in the zips 2026-11-18 20:57:57 -05:00
tests docs(self-hosting): add the one-page self-hosting document and ship it in the zips 2026-11-18 20:57:57 -05:00
tools build(vendor): take delivery-tooling 1.3.0 and mark the five visible exceptions 2026-11-18 16:31:43 -05:00
vendor/authored-profiles feat(presentation): take authored-profiles 1.1.0 so every build can preview a character package 2026-11-18 04:37:59 -05:00
.commitlintrc.cjs fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
.gitignore fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
.gitlab-ci.yml fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
.gitlint fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
.releaserc.cjs fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
AGENTS.md docs(agents): update the privatelocalchat instructions and skills 2026-11-18 20:17:31 -05:00
app-config.json feat(models): load models from the shared CDN, cdn.aiofourown.com 2026-11-17 20:55:40 -05:00
CHANGELOG.md fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
CLAUDE.md fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
CONTRIBUTING.md fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
conversation-messages.mjs fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
index.html feat(discovery): open a listed resource from a discovery page link, checked against its listing 2026-11-18 05:52:15 -05:00
LICENSE docs(licence): release Private Local Chat under the AGPL-3.0 2026-11-17 21:27:07 -05:00
local-models.css fix(agents): restore source files omitted by the skill rollout 2026-11-17 16:22:20 -05:00
local-models.js refactor(runtime): the model host takes its settings store as an argument 2026-11-17 22:37:10 -05:00
neutrality-exceptions.json docs(self-hosting): add the one-page self-hosting document and ship it in the zips 2026-11-18 20:57:57 -05:00
package-lock.json docs(licence): release Private Local Chat under the AGPL-3.0 2026-11-17 21:27:07 -05:00
package.json docs(licence): release Private Local Chat under the AGPL-3.0 2026-11-17 21:27:07 -05:00
README.md docs(ops): say the shared CDN is the source and cdn_publish.py publishes 2026-11-17 22:24:44 -05:00
THIRD-PARTY-NOTICES.md feat(presentation): take authored-profiles 1.1.0 so every build can preview a character package 2026-11-18 04:37:59 -05:00
vendor.lock.json build(vendor): take delivery-tooling 1.3.0 and mark the five visible exceptions 2026-11-18 16:31:43 -05:00

Private Local Chat

Chat with Qwen3.5 on your device, or explicitly choose an OpenAI-compatible API provider. Conversations remain in the browser's existing chatThreads storage; API settings retain the existing session-storage format.

Choose On this device, select a model, press Download model. The download retries automatically and loads the model when complete. After reopening a completed session, use Load model to load its saved files. The smaller Qwen3.5-2B download is about 1.20 GB. Qwen3.5-9B is about 5.06 GB and requires substantially more GPU memory. Model size is separate from working memory. Both runtimes require WebGPU, and the 2B runtime also requires shader-f16; supported browser/device combinations must be confirmed by the release acceptance checks.

The downloader checks pinned SHA-256 hashes, retains complete files when interrupted, and supports explicit repair. Models and the app shell can be stored for offline use. Browser storage can be evicted; export important chats. Local mode never falls back to an API. Selecting API mode sends conversation context to the provider you configure.

Development

Node.js 22 or later:

npm ci
npm test
npm run build
node scripts/serve.mjs

Open http://127.0.0.1:18171. Build output is dist/; it contains no credentials or private chat data. A build with no setup is a complete app with neutral Help and About pages (run-kit/); the pages of privatelocal.chat are a separate, private site layer that the deploy adds (docs/SITE-LAYER.md). The app shows its environment, version, and full deployed commit via version.json.

See everyday chat features for rendered answers, message controls, search, documents, memory, speech, storage and backups, and npm run e2e for the browser tests.

Where this repository lives and how a clone is made ready: housing.

See the maintainer handoff, operations, runtime provenance, and release acceptance. How the app, the site layer and a copy you host fit together: the site layer, links to pages, running a copy and the headers it needs, configuration and model sources, upgrades, and data and file compatibility.

The living iPhone investigation plan records the current reliability evidence, next experiment, decision criteria, and results log. Update it as the investigation progresses.