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

Uploaded CPython 3.13macOS 15.0+ x86-64

localcode-0.2.11rc1-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.11rc1-cp313-cp313-macosx_15_0_arm64.whl (11.9 MB view details)

Uploaded CPython 3.13macOS 15.0+ ARM64

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

Uploaded CPython 3.12macOS 15.0+ x86-64

localcode-0.2.11rc1-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.11rc1-cp312-cp312-macosx_15_0_arm64.whl (11.9 MB view details)

Uploaded CPython 3.12macOS 15.0+ ARM64

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

Uploaded CPython 3.11macOS 15.0+ x86-64

localcode-0.2.11rc1-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.11rc1-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.11rc1-cp313-cp313-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp313-cp313-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 f99bf6a7fd4ca7b2b512215011e533ad4cf84a2f62ea7b0ad33713fb9b89b53e
MD5 94f211e2de3452c3354ddd5ca3824729
BLAKE2b-256 b3f2988eab855d36b6f094d9da7e340d98bb191acc67a0daedde66363d161889

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp313-cp313-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 4d465526a9cdd796787931841a6661f13a9a1da76816ed6c387616c2545a068a
MD5 d9f6d0b30bae38617adb0045849705c7
BLAKE2b-256 3f73fec0cb0985dca8ed50bc65b7ecc84147b668c58a26b0eef98a65478b54af

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp313-cp313-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 25993ff39fa7f278740f994dad8b7221567c627ee8587ea3df05b6f8e0d96643
MD5 ce8b2cb1a5a567a5badb8d4e41cd469c
BLAKE2b-256 559a11169e2f13012a4ab6b1a7c84e13b054af2c753d6787f53f1fdfffb09a83

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp312-cp312-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 0743191a7f4777e52f70dd54cbe4021f13a42ea6b7be0d3b6f62eef954a3f5ea
MD5 f1bf6224e9d165643798b060793d2f6c
BLAKE2b-256 98eab7dbe9f6ced469a24c6a4925dae6f833232c59489dda007cd9dcd7bdfd99

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp312-cp312-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 12fa05ed9ec3669392e22b322c3c1cb2100e1e5326eb2aeb60702cb1e862e551
MD5 11382410484588d52ff1e989d6a0eeb0
BLAKE2b-256 c0ba9c5389ee29c1e3fbb3ae27f608b9518041553fbb70a31b21f0405bda549d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp312-cp312-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 8438610bf6907f03d96859530145e808f5ff1210557627cae8c9c605ef63106a
MD5 bff1df871cca5c041824b8ab3ad8da6e
BLAKE2b-256 1dda2b4db809d34bd9a76f563181923c6eb4d8d3f4c7c5b6b6cc82a9a6c6914c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp311-cp311-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 f554f1309fdee04c69c240f09d4a7ce44159af3d61d397504dcce9673992deb4
MD5 49726cb7acb123005ebc519c45d67b28
BLAKE2b-256 cedbb23394d804e650da78315048a92b1787cca5802ea9572d7fe88792aad41d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp311-cp311-macosx_15_0_universal2.whl
Algorithm Hash digest
SHA256 74b27ce1f2729a3f6abae233d9774f667cc83571224983333fbb76e88cc9b68f
MD5 7b4efe5813ab0d03c192bb41d5e2f4a2
BLAKE2b-256 9b1a3963d878d0fbb16c2a6c3eab7f83b94718c40685128601e0637b966af2f8

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for localcode-0.2.11rc1-cp311-cp311-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 bd53edf3bcb2a4cf8ece476c33dc31f72399952196bdd274be852c34e77e55cb
MD5 338d3907a6ef544a44276ccba2581434
BLAKE2b-256 947f0b394403ca27ca7db441db5dfb9c15262dfd65956a6b2d5e9fd6b5c3503f

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