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.11rc7-cp311-cp311-macosx_15_0_x86_64.whl (12.1 MB view details)

Uploaded CPython 3.11macOS 15.0+ x86-64

localcode-0.2.11rc7-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.11rc7-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.11rc7-cp311-cp311-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc7-cp311-cp311-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 abc8c1d1b30d78d51ddaabe69ca0d3b7508914c2fe9bb967adbdb7aa6d396182
MD5 2fa2f0233ad8f5fe05347cd828e649e6
BLAKE2b-256 9d1ca8393b6f025b66c8aa1a37b627eed32e204bb1e0efd415f65ae2404890e9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc7-cp311-cp311-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 dbdd04a2246246aa3e9319c6caf3fe17598e21420c8a96308d678ca4f8ebf194
MD5 70062caad8ab1ff2e2906647f8275a91
BLAKE2b-256 bd9cdbeccff04afbef606833881471a85a355976478b04035dbab35e42b1be15

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc7-cp311-cp311-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 0b364760d80b66ee055eba8e310daeb7ef9501d7f45e65994f328624e6d38dcf
MD5 8125915623039acae26342cc731c5744
BLAKE2b-256 fd2ce7c7b461b4ace97685621ed62c6a5c741264104ce64eaee41b995f2caa99

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