lcode-cli 0.1.1__py3-none-any.whl

lcode_cli-0.1.1.dist-info/METADATA

@@ -0,0 +1,181 @@
+Metadata-Version: 2.5
+Name: lcode-cli
+Version: 0.1.1
+Summary: A local-first terminal coding agent powered by open-weight models on your own GPU or Mac, via Ollama.
+Project-URL: Homepage, https://nasser1941.github.io/lcode/
+Project-URL: Documentation, https://nasser1941.github.io/lcode/
+Project-URL: Repository, https://github.com/nasser1941/lcode
+Project-URL: Issues, https://github.com/nasser1941/lcode/issues
+Project-URL: Changelog, https://github.com/nasser1941/lcode/blob/main/CHANGELOG.md
+Author: Naser Derakhshan
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,cli,coding-agent,developer-tools,llm,local-llm,ollama,qwen
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Requires-Dist: prompt-toolkit>=3.0.43
+Requires-Dist: requests>=2.31
+Requires-Dist: rich>=13.7
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="docs/assets/logo.svg" width="96" alt="lcode logo">
+</p>
+
+<h1 align="center">lcode</h1>
+
+<p align="center">
+  <b>A coding agent that runs entirely on your own machine.</b><br>
+  Open-weight models · up to 256K tokens of context · your NVIDIA GPU or Apple Silicon Mac · no API keys, no cloud
+</p>
+
+<p align="center">
+  <a href="https://github.com/nasser1941/lcode/actions/workflows/ci.yml"><img src="https://github.com/nasser1941/lcode/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://nasser1941.github.io/lcode/"><img src="https://github.com/nasser1941/lcode/actions/workflows/docs.yml/badge.svg" alt="Docs"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+">
+  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20(Apple%20Silicon)-lightgrey.svg" alt="Linux and macOS">
+</p>
+
+<p align="center">
+  <a href="https://nasser1941.github.io/lcode/"><b>Documentation</b></a> ·
+  <a href="https://nasser1941.github.io/lcode/installation/">Install</a> ·
+  <a href="https://nasser1941.github.io/lcode/models/">Models</a> ·
+  <a href="CONTRIBUTING.md">Contributing</a>
+</p>
+
+<p align="center">
+  <img src="docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
+</p>
+
+Point lcode at a repository and talk to it in your terminal. It explores the code, answers
+questions with `file:line` references, writes and edits files, runs your scripts and tests, and
+keeps going until the task is done, asking before it changes anything. The model runs locally
+through [Ollama](https://ollama.com), so your code never leaves your machine.
+
+## Features
+
+- **A real agent.** Reads, searches, edits and runs commands in a loop, checks its own work, and
+  plans multi-step tasks with a visible todo list.
+- **Long context.** 256K tokens with the default model (1M with Nemotron). You choose the window.
+- **Hardware-aware.** Detects your NVIDIA GPU or Apple Silicon Mac and picks the best model and the
+  largest context that fits: `lcode setup` does it in one step.
+- **Safe by default.** Every edit is shown as a diff and every command that isn't read-only needs
+  your approval. `auto-edit` and `yolo` modes when you want speed.
+- **Bring your own model.** Eight curated open-weight models, or any Ollama model with tool calling.
+- **Private.** No telemetry, no accounts, no API keys.
+
+## Install
+
+**Ubuntu / Linux** (NVIDIA GPU recommended) and **macOS** on Apple Silicon (M1–M4):
+
+```bash
+curl -fsSL https://nasser1941.github.io/lcode/install.sh | bash
+```
+
+The installer sets up lcode with its own Python via [uv](https://docs.astral.sh/uv/), checks for
+[Ollama](https://ollama.com) (0.30+) and runs `lcode setup`, which picks a model for your hardware
+and downloads it. Prefer manual steps? See the
+[installation guide](https://nasser1941.github.io/lcode/installation/), or:
+
+```bash
+uv tool install git+https://github.com/nasser1941/lcode
+lcode setup
+```
+
+## Quickstart
+
+```bash
+cd ~/code/your-project
+lcode
+```
+
+```text
+❯ /init                                   # study the repo and write AGENTS.md for future sessions
+❯ How does authentication work here? Cite files.
+❯ Write scripts/dedupe.py that removes duplicate rows from @data/users.csv by email, and run it
+❯ The tests in tests/test_parser.py fail. Find out why and fix it.
+```
+
+| | |
+|---|---|
+| `lcode -p "…"` | one request, no interaction (scripts, hooks) |
+| `lcode -c` | continue the last session in this directory |
+| `lcode --model qwen3.5-9b --context 128k` | pick a model and context window for this session |
+| `lcode models` / `lcode doctor` | what fits this machine / check the installation |
+| `/model`, `/ctx 128k`, `/compact`, `/help` | switch model, resize context, summarize, list commands |
+
+## Models
+
+| Key | Model | Download | Max context | |
+|---|---|---|---|---|
+| `qwen3.6-35b` | Qwen3.6 35B-A3B Coding (MoE, 3B active) | 22.6 GB | 256K | **default**, tested |
+| `qwen3.8-27b` | Qwen3.8 27B (dense) | 17.7 GB | 256K | |
+| `qwen3.6-27b` | Qwen3.6 27B Coding (dense) | 17.8 GB | 256K | |
+| `laguna-xs-2.1` | Poolside Laguna XS 2.1 (MoE, 3B active) | 20.3 GB | 256K | |
+| `nemotron-3.5-lightning` | NVIDIA Nemotron 3.5 Lightning (hybrid MoE) | 25.4 GB | 1M | |
+| `gpt-oss-20b` | OpenAI gpt-oss 20B (MoE) | 13.8 GB | 128K | |
+| `qwen3.5-9b` | Qwen3.5 9B (dense) | 6.6 GB | 256K | tested |
+| `qwen3.5-4b` | Qwen3.5 4B (dense) | 3.4 GB | 256K | tested |
+
+What `lcode setup` picks for common machines:
+
+| Machine | Model | Context |
+|---|---|---|
+| Mac with M4, 16 GB | qwen3.5-9b | 64K |
+| Mac with M4 / M4 Pro, 24 GB | qwen3.5-9b | 256K |
+| Mac with M4 Pro / M4 Max, 36 GB | qwen3.6-35b | 64K |
+| Mac with M4 Pro, 48 GB · M4 Max, 64 GB+ | qwen3.6-35b | 256K |
+| NVIDIA 8–24 GB + 32 GB RAM | qwen3.6-35b | 256K |
+| NVIDIA 8 GB + 16 GB RAM | qwen3.5-4b | 64K |
+
+On an RTX 4080 Laptop GPU (12 GB) the default model generates 50–60 tokens/s at 256K context, and
+qwen3.5-9b 64 tokens/s at 128K. See
+[Models & context windows](https://nasser1941.github.io/lcode/models/) for memory estimates and
+tuning.
+
+## How it works
+
+lcode sends your request, the repository layout and a set of tool definitions to the model; runs the
+tools the model calls (read, edit, grep, glob, bash, todo); feeds the results back; and repeats until
+the model answers. It sizes models to your memory from each model's KV-cache footprint, uses
+text-only model variants to free GPU memory, and summarizes the conversation when the context window
+fills up. Details: [How it works](https://nasser1941.github.io/lcode/how-it-works/).
+
+## Roadmap
+
+- More models in the catalog, with community test reports ([request one](https://github.com/nasser1941/lcode/issues/new?template=model_request.yml))
+- Measured Apple Silicon performance numbers
+- MCP (Model Context Protocol) tool servers
+- Web fetch and search tools
+- Packaging on PyPI and Homebrew
+
+## Contributing
+
+Contributions are welcome: bug reports, model test results, docs and code. See
+[CONTRIBUTING.md](CONTRIBUTING.md). Please follow the [code of conduct](CODE_OF_CONDUCT.md), and
+report security issues privately as described in [SECURITY.md](SECURITY.md).
+
+## Acknowledgements
+
+lcode stands on [Ollama](https://ollama.com) and [llama.cpp](https://github.com/ggml-org/llama.cpp),
+the open-weight models from Qwen, Poolside, NVIDIA and OpenAI,
+[Rich](https://github.com/Textualize/rich) and
+[prompt_toolkit](https://github.com/prompt-toolkit/python-prompt-toolkit).
+
+## License
+
+[MIT](LICENSE) © 2026 Naser Derakhshan

lcode_cli-0.1.1.dist-info/RECORD

@@ -0,0 +1,18 @@
+lcode/__init__.py,sha256=czDagA2Y7vJ-F5wm2C4CrWmBci7DnShS1yCOE3nEjbQ,117
+lcode/__main__.py,sha256=s5N5pryX2FAu93GGZ3FxUrIXHWGzxz66lKUoaV_h8Ws,35
+lcode/agent.py,sha256=Tc9HYFzASMpVGYWxX_U7RWqNTZK2czaPjGBjlHs-P1I,17427
+lcode/catalog.py,sha256=pZ1azX9OH2r4JE2c6E5OfwywpgS39-W2oXzoCHJhmtM,4141
+lcode/cli.py,sha256=7Pfq_mnZ-tIhFfe_YpVohRwt236I1an2-4TN0sWqvfg,18789
+lcode/config.py,sha256=NvsiWFyGyDpEKHwWDrW643yYLRG4Omp8Qnp_68K2a_Y,5038
+lcode/hardware.py,sha256=2VbknZCxTZJwJUD8YWdQ7ryEQo_LcjtoOBOHOU9Y0fw,3085
+lcode/models.toml,sha256=23KFX9z6WPQPXZEhD1SV9OxQowHY9TEp0IDwxIPbYb4,3949
+lcode/ollama.py,sha256=fELwqw7xqLH9TM7XvdI1pxqYZFeIRJBv-VSz9REdvwA,6516
+lcode/permissions.py,sha256=6nPOlr0ARoI_ZXfugIq4r8TUZj2wE8SSvpjp9zdC578,3890
+lcode/render.py,sha256=gMvf4W3qkLUJ4Vot3az_hP_zRDAItJC9pP-68dHFkfA,1375
+lcode/repl.py,sha256=BL8bQcJ6tw4uadF2bELsFwshPe5SOKZOZQob5ybUpzM,10816
+lcode/tools.py,sha256=99XvUhNs1YjjqXORmiu3NI9jC0FX11eJkI1sENWtq5s,22206
+lcode_cli-0.1.1.dist-info/METADATA,sha256=3X8oSBoTEydGadmN0JHrpI9-EMGzLC9Df4n52Gq94Dc,8158
+lcode_cli-0.1.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+lcode_cli-0.1.1.dist-info/entry_points.txt,sha256=pZ_uDQ98UzVAHUQeXn5HeyQWKGSH3r3T5aPHuSB89eI,41
+lcode_cli-0.1.1.dist-info/licenses/LICENSE,sha256=JWjmoL7nNIC1XUa-dZm2hwLUgjUQMFo6k8APb0idNzs,1074
+lcode_cli-0.1.1.dist-info/RECORD,,

lcode_cli-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

lcode_cli-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+lcode = lcode.cli:main

lcode_cli-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Naser Derakhshan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+