Skip to main content

High-performance AI coding on consumer hardware.

Project description

🏠 LocalCode

Build Release License Python Platform

High-performance AI coding on consumer hardware.
No cloud, no API keys, no data leaving your machine.

Install

pip install localcode

Run

cd your-project
localcode

That's it. First launch builds the inference server and downloads the model (~5 min, one time). After that, startup is ~15 seconds.

What it does

  • Reads and edits files - understands your codebase, makes surgical edits
  • Runs commands - tests, builds, git, shell
  • Searches code - by pattern, content, or semantic meaning
  • Fast mode - for routine coding tasks
  • Reasoning mode - deep thinking for complex multi-step problems
  • Uses tools automatically - the model picks its own tools
> refactor the auth module to use JWT and make sure the tests pass

LocalCode reads the files, plans the refactor, edits the code, runs the tests, and fixes failures - all locally.

Why local?

We are building for a world of truly democratized AI - where everyone has access to powerful, personalized, prompt AI anywhere, on any device, and in any location. True empowered local-first AI. LocalCode is the first step toward that vision.

How LocalCode compares

LocalCode Claude Code OpenCode Codex CLI
Runtime 100% on-device Cloud (Anthropic API) Cloud (any provider) Cloud (OpenAI API)
Privacy Code never leaves your machine Code sent to Anthropic Code sent to provider Code sent to OpenAI
Cost Free forever $100+/mo (Max) or API credits API credits (varies) Free (included with ChatGPT)
Internet required No Yes Yes Yes

Requirements

  • Mac with Apple Silicon (M1/M2/M3/M4)
  • 16GB RAM minimum
  • Python 3.11+
  • ~12GB free disk (10GB model + server)

How LocalCode works

LocalCode runs a custom llama.cpp fork with TurboQuant KV cache compression - a technique from Google's ICLR 2026 paper that we patched into llama.cpp for Apple Silicon. This compresses the KV cache 3.8x, fitting 32K context in 355 MiB on a 16GB MacBook.

The model (Gemma 4 26B-A4B) is a Mixture-of-Experts architecture - 25.2B total parameters but only 3.8B active per token. That's what makes 27 tok/s possible on a laptop.

Sponsors

If you'd like to sponsor LocalCode, reach out.

Contributing

See CONTRIBUTING.md.

License

Apache-2.0. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

localcode-0.2.11rc8-cp313-cp313-macosx_15_0_x86_64.whl (12.1 MB view details)

Uploaded CPython 3.13macOS 15.0+ x86-64

localcode-0.2.11rc8-cp313-cp313-macosx_15_0_universal2.whl (16.1 MB view details)

Uploaded CPython 3.13macOS 15.0+ universal2 (ARM64, x86-64)

localcode-0.2.11rc8-cp313-cp313-macosx_15_0_arm64.whl (11.9 MB view details)

Uploaded CPython 3.13macOS 15.0+ ARM64

localcode-0.2.11rc8-cp312-cp312-macosx_15_0_x86_64.whl (12.1 MB view details)

Uploaded CPython 3.12macOS 15.0+ x86-64

localcode-0.2.11rc8-cp312-cp312-macosx_15_0_universal2.whl (16.2 MB view details)

Uploaded CPython 3.12macOS 15.0+ universal2 (ARM64, x86-64)

localcode-0.2.11rc8-cp312-cp312-macosx_15_0_arm64.whl (11.9 MB view details)

Uploaded CPython 3.12macOS 15.0+ ARM64

localcode-0.2.11rc8-cp311-cp311-macosx_15_0_x86_64.whl (12.1 MB view details)

Uploaded CPython 3.11macOS 15.0+ x86-64

localcode-0.2.11rc8-cp311-cp311-macosx_15_0_universal2.whl (16.2 MB view details)

Uploaded CPython 3.11macOS 15.0+ universal2 (ARM64, x86-64)

localcode-0.2.11rc8-cp311-cp311-macosx_15_0_arm64.whl (11.9 MB view details)

Uploaded CPython 3.11macOS 15.0+ ARM64

File details

Details for the file localcode-0.2.11rc8-cp313-cp313-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp313-cp313-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 dd614540d1c283f863c8444cc2444fbfdc356cde67998a5c4d47182dff4b29f7
MD5 e21e163563d21d9c29201b7f89ea3efa
BLAKE2b-256 c0dc987bc4421ddd16dafeca530d98cc6bc0be3bc4ac0860d8207992e3840123

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp313-cp313-macosx_15_0_universal2.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp313-cp313-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 df78595a2e0b144c4a8f3f86befd82c31fce863c36ee48673ad33fe2725a4832
MD5 3db482bce94a710b68bc6cd6a374d330
BLAKE2b-256 100993c88e4c9828e88605cb62fd7ca8d4d431d90048ae6f7e3c69469ef69717

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp313-cp313-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp313-cp313-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 e73c3116b6c7bcb76b10e32bd69318c7aa524797902f0a37e1bdc62221362026
MD5 fb7306abab671b7512ff39b9c26e6205
BLAKE2b-256 8f3f120c14ed6aaa39a3f88530030e38c1267b4e4a5bdfd130ac947d0907f987

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp312-cp312-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp312-cp312-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 80709e7c52eb17dd331f42f584d5ad85c3955cc3b90b9df5fccb3e9f86ad598a
MD5 49d9e0580286ac68b49675ff32574faf
BLAKE2b-256 48dd1a83888e0473ce2cfe9fcabeb41f332c9763a9bf45fec377093b5a283afb

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp312-cp312-macosx_15_0_universal2.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp312-cp312-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 e9e828dc6689ff61be9e715540eeda5b652ac1d5d282a3ecd1922da9e66b3764
MD5 fbea1d4b1107dd695f25c6934e1b3d5c
BLAKE2b-256 867961bad2eec85f11f360d84feb07d7097d26d8de18d36f0ebfe149eb8eb094

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp312-cp312-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp312-cp312-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 63a3c79e7f4d20bb9dac3da90ab1350d12fe7ae77a28327b87c220beb25f6abc
MD5 0236d5b8726bb3d2dff6f77eeeaa10ac
BLAKE2b-256 c4d0fb66208f396c847ca9c7fe7192db4254d72cce00082333c4ebe122f6c3b0

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp311-cp311-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp311-cp311-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 df446d02db2e1481e1c6a0ffcc5caefa7413ebf22a4960938cdf1acad1589119
MD5 5ec9f8350ce40154f5325aed65717814
BLAKE2b-256 41176cc0ecd06efcee4af8bdd92e89011c2d5a6a4cde94a9ce514abf471b7b31

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp311-cp311-macosx_15_0_universal2.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp311-cp311-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 e15d0b3a2f31533d19900f2034c15560f813f8b6455950ab0754feb80878a088
MD5 d82cd2b09c2ba98291af868603cffa12
BLAKE2b-256 1f1d563bc70a980d44ab166714f70da2fc9cb44fca1d11251439c872e3573836

See more details on using hashes here.

File details

Details for the file localcode-0.2.11rc8-cp311-cp311-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc8-cp311-cp311-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 0159bd975d8c9f0a2218e96dd485047bb28fbfbdd2c3e791685b40d2fca1ace5
MD5 26054b70ff4ba76115aa375f5bf6aee0
BLAKE2b-256 e28b619b6f0da3c6a6224bfbe1718d83fa3f0013eced28d32d9e3471b584603b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page