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.10-cp313-cp313-macosx_15_0_x86_64.whl (12.0 MB view details)

Uploaded CPython 3.13macOS 15.0+ x86-64

localcode-0.2.10-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.10-cp313-cp313-macosx_15_0_arm64.whl (11.9 MB view details)

Uploaded CPython 3.13macOS 15.0+ ARM64

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

Uploaded CPython 3.12macOS 15.0+ x86-64

localcode-0.2.10-cp312-cp312-macosx_15_0_universal2.whl (16.1 MB view details)

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

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

Uploaded CPython 3.12macOS 15.0+ ARM64

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

Uploaded CPython 3.11macOS 15.0+ x86-64

localcode-0.2.10-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.10-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.10-cp313-cp313-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp313-cp313-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 8b2308fe001f86cdf02f47218e0b607459b2e715b2e79dbd4323edc28814cb05
MD5 e76fee3fe739cc1d572fb102a19da733
BLAKE2b-256 0fdb3db28563527a279dda7230cd52fc54b3046e0b7d2112207d88dbe8b9eb70

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp313-cp313-macosx_15_0_universal2.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp313-cp313-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 0615408ac643709d1bb2a37be4e8c66953fa3f9332c33665726817c8f19d164d
MD5 48f7c1e82d9f4e1e6ca7b97fac6c93d2
BLAKE2b-256 7c16a4c2912decaee47c1802e02868e4f1fa1a2fae350079e0ec57aad2129719

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp313-cp313-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp313-cp313-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 0d7697254ab8cc12dc6e080ff21e992ef9db0d6f84a7abb9bfc26258b6840797
MD5 af96ff5c08d58d51448741b558d96581
BLAKE2b-256 71f0b7c561354d45c38b1014503b9788edc458cbd435f359987f152d9713d41b

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp312-cp312-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp312-cp312-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 e9950682b71984cb4719a7cb0f518770d1221649160dbbee686ce64c0736e7a8
MD5 0ab539d9df654c896b747abac393301b
BLAKE2b-256 647f34b4f488c12f60e102888015ab64a8898b476d0ea7bc5170e641479ddca3

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp312-cp312-macosx_15_0_universal2.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp312-cp312-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 e0dd324b43406e7feb4b36da9a82d70ffc45368e4dc18a2b0b1aee714c4bf0c8
MD5 f4624139d098b5513b36cec589c76008
BLAKE2b-256 198920e088678f91b314581e8bb8101802ee3e384734676f76f99acb2811dc37

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp312-cp312-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp312-cp312-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 f38e6add3f83aea969aeb88d852b5e55c4f739576cddff61abcbab0757cade11
MD5 cd766bf2b1db8ec40589c7a300b526dd
BLAKE2b-256 ea12b0e90a1ab9b77f8ee5bb931bfd851f953de57a9cba45a13cc71d518bf57a

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp311-cp311-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp311-cp311-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 6fda41a6d01c1a7b8b35b6f69c728573e90095bb8dfe0477dc214c8faa8b982e
MD5 537429e7917ab8b439e0b29090ed85d3
BLAKE2b-256 5928b2ac14a0660b6061691141b160a07c38c66d5502526782b4479630a10f79

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp311-cp311-macosx_15_0_universal2.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp311-cp311-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 849c83620fde1d600c58c51923f55a29f629555ffa3c2898b112fac8ec91b672
MD5 6f05dd71659656b176fe9e9f921c0ee4
BLAKE2b-256 8294852808a3603b8efd231ea69803c165eec1cf6115fe4c27a53ad539c8146e

See more details on using hashes here.

File details

Details for the file localcode-0.2.10-cp311-cp311-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for localcode-0.2.10-cp311-cp311-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 7660e2fba667982ddc08d684829d25b4bb235bd6229491c522c97cf2a735df55
MD5 454353ac4b0f912dedf4d1736e258cf7
BLAKE2b-256 06874c70e9231f7a8306a783ab3e1dd54294fee9b10de37863aa1c7d1d915a60

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