yolo-coder 0.0.2__tar.gz

yolo_coder-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Erdem OZKAN
+
+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.

yolo_coder-0.0.2/PKG-INFO

@@ -0,0 +1,460 @@
+Metadata-Version: 2.4
+Name: yolo-coder
+Version: 0.0.2
+Summary: An AI agent that fixes your broken CLI commands automatically using a local LLM
+Author-email: erdemozkan <ozkanerdem@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/erdemozkan/YOLO-CODER
+Project-URL: Repository, https://github.com/erdemozkan/YOLO-CODER
+Project-URL: Bug Tracker, https://github.com/erdemozkan/YOLO-CODER/issues
+Keywords: ai,llm,cli,debugging,automation,ollama,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Debuggers
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: colorama>=0.4.6
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/yolo-coder-logo.png" alt="YOLO Logo" width="320" />
+</p>
+
+<h1 align="center">YOLO — You Only Launch Once</h1>
+
+<p align="center">
+  <strong>An AI agent that fixes your broken CLI commands. Automatically. While you watch.</strong>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
+  <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.10%2B-blue.svg" alt="Python 3.10+" /></a>
+  <a href="https://ollama.com"><img src="https://img.shields.io/badge/Powered%20by-Ollama-black.svg" alt="Ollama" /></a>
+  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome" />
+  <img src="https://img.shields.io/badge/privacy-100%25%20local-green.svg" alt="100% Local" />
+</p>
+
+> [!CAUTION]
+> **Disclaimer:** YOCO is experimental and can modify/delete files. Use it in isolated environments like Docker. See [DISCLAIMER.md](DISCLAIMER.md) for full details.
+
+---
+
+## The pitch
+
+You run a command. It breaks. You stare at the error. You Google it. You copy-paste from Stack Overflow. It breaks again. You question your life choices.
+
+**Or:** you run YOLO. It sees the error. It fixes it. It retries. You get coffee.
+
+```bash
+$ yoco python3 myapp.py
+```
+
+That's it. That's the whole interface.
+
+---
+
+## Demo
+
+### Brain 1 — Interceptor: missing package fixed in under a second
+<p align="center">
+  <img src="assets/01_basic_fix.gif" alt="YOCO fixes a missing package instantly" width="800" />
+</p>
+
+### Brain 3 — Local LLM: patches a logic bug in your code
+<p align="center">
+  <img src="assets/02_llm_fix.gif" alt="YOCO uses local LLM to fix a ZeroDivisionError" width="800" />
+</p>
+
+### Brain 2 — Fix Memory: same error, instant replay
+<p align="center">
+  <img src="assets/03_memory_hit.gif" alt="YOCO recalls a past fix and applies it instantly" width="800" />
+</p>
+
+### Rollback: undo everything YOCO changed
+<p align="center">
+  <img src="assets/04_rollback.gif" alt="YOCO interactive rollback picker" width="800" />
+</p>
+
+### Dry Run: preview the fix before applying it
+<p align="center">
+  <img src="assets/05_dry_run.gif" alt="YOCO dry run mode" width="800" />
+</p>
+
+### Security Gate: blocks git push when an API key is exposed
+<p align="center">
+  <img src="assets/06_security.gif" alt="YOCO blocks git push due to exposed OpenAI API key" width="800" />
+</p>
+
+### Watch Mode: auto-fixes on every file save
+<p align="center">
+  <img src="assets/07_watch.gif" alt="YOCO watch mode fixes two bugs automatically as files change" width="800" />
+</p>
+
+---
+
+## What actually happens under the hood
+
+YOLO has three brains, tried in order from fastest to slowest:
+
+```
+Error hits
+    │
+    ▼
+┌─────────────────────────────────────────────────┐
+│  Brain 1: Interceptors                          │  ← 23 regex rules
+│  "ModuleNotFoundError: No module named 'flask'" │    fires in <1ms
+│  → pip install flask                            │    no LLM involved
+└─────────────────────────────────────────────────┘
+    │ no match
+    ▼
+┌─────────────────────────────────────────────────┐
+│  Brain 2: Fix Memory                            │  ← remembers past fixes
+│  "seen this IndexError before (3x)"             │    fires in <5ms
+│  → replay the fix that worked last time         │    no LLM involved
+└─────────────────────────────────────────────────┘
+    │ cache miss
+    ▼
+┌─────────────────────────────────────────────────┐
+│  Brain 3: Local LLM                             │  ← fine-tuned Qwen2.5-Coder
+│  reads your error + your code                   │    runs 100% locally
+│  → generates a targeted fix command             │    ~1-3 seconds on Apple Silicon
+└─────────────────────────────────────────────────┘
+```
+
+Fix works → snapshot it, remember it, move on.
+Fix fails → roll back every file to its pre-YOLO state, try again.
+
+---
+
+## Install
+
+### 1. Clone and install YOCO
+
+```bash
+git clone https://github.com/erdemozkan/YOLO-CODER
+cd YOLO-CODER
+pip install -e .
+```
+
+### 2. Install Ollama
+
+Download from [ollama.com](https://ollama.com) or:
+
+```bash
+brew install ollama
+ollama serve   # start the server (runs on http://localhost:11434)
+```
+
+### 3. Set up the AI model
+
+**Option A — Pull directly from Hugging Face (easiest):**
+
+```bash
+# 1.5B model — fast, ~941MB, runs on any machine
+ollama run hf.co/erdemozkan/YOLO-1.5B-Qwen-Coder
+
+# 7B model — smarter, ~4.4GB, needs ~6GB RAM
+ollama run hf.co/erdemozkan/YOLO-7B-Qwen-Coder
+```
+
+**Option B — Download GGUF manually and register:**
+
+```bash
+# Download the Q4 GGUF from HuggingFace
+# → https://huggingface.co/erdemozkan/YOLO-7B-Qwen-Coder/blob/main/YOLO-7B-Qwen-q4.gguf
+
+# Create a Modelfile
+cat > Modelfile <<'EOF'
+FROM ./YOLO-7B-Qwen-q4.gguf
+
+TEMPLATE """{{ if .System }}<|im_start|>system
+{{ .System }}<|im_end|>
+{{ end }}<|im_start|>user
+{{ .Prompt }}<|im_end|>
+<|im_start|>assistant
+"""
+
+PARAMETER stop "<|im_start|>"
+PARAMETER stop "<|im_end|>"
+PARAMETER temperature 0.1
+PARAMETER top_p 0.1
+SYSTEM """You are a CLI repair tool. Output ONLY a single bare bash command to fix the error. No explanation. No markdown. No backticks."""
+EOF
+
+# Register with Ollama
+ollama create yolo-7b -f Modelfile
+
+# Verify it works
+ollama run yolo-7b "ModuleNotFoundError: No module named 'requests'"
+# → pip install requests
+```
+
+### 4. Configure YOCO to use your model
+
+```bash
+mkdir -p ~/.yolo
+# Use 1.5B (default, fast):
+echo '{"model": "hf.co/erdemozkan/YOLO-1.5B-Qwen-Coder"}' > ~/.yolo/config.json
+
+# Or use 7B (if registered manually as above):
+echo '{"model": "yolo-7b"}' > ~/.yolo/config.json
+```
+
+### 5. Run it
+
+```bash
+yoco python3 myapp.py
+```
+
+---
+
+## Usage
+
+```bash
+# Basic: fix whatever breaks
+yoco python3 myapp.py
+yoco npm run dev
+yoco cargo build
+yoco docker-compose up
+
+# See what it would do without doing it
+yoco --dry-run python3 myapp.py
+
+# Get a full AI explanation of what went wrong and why
+yoco --explain python3 myapp.py
+
+# Watch mode: re-run on every file save
+yoco --watch python3 myapp.py
+
+# Undo everything YOLO changed in the last session
+yoco --rollback
+
+# Undo a specific file
+yoco --rollback src/main.py
+
+# Browse history of past runs
+yoco --history
+
+# Use the bigger 7B model for hard errors
+yoco --model yolo-7b python3 myapp.py
+```
+
+---
+
+## What it can fix right now
+
+| Category | Examples |
+|---|---|
+| **Python** | `ModuleNotFoundError`, `SyntaxError`, `PermissionError`, `FileNotFoundError`, `IndexError`, `ZeroDivisionError`, `AttributeError`, `KeyError`, `TypeError` |
+| **pip** | `DEPRECATION`, `--break-system-packages`, missing packages, hash mismatches |
+| **Node.js** | `Cannot find module`, `MODULE_NOT_FOUND` |
+| **npm** | `ENOENT`, `ERESOLVE` (peer deps), `EACCES` (permissions) |
+| **TypeScript** | `TS2304` (cannot find name), `TS2339` (property does not exist) |
+| **Docker** | Image not found, port already in use, container name collision, daemon not running |
+| **Git** | Merge conflicts, detached HEAD, push rejected, nothing to commit, not a repo |
+| **Everything else** | LLM fallback covers what the rules don't |
+
+---
+
+## The model
+
+YOLO ships with fine-tuned `Qwen2.5-Coder` models trained specifically on CLI error/fix pairs. It's trained to output exactly one bare shell command — no markdown, no explanation, no backticks. Just the fix.
+
+**Our fine-tuned models are live on Hugging Face!**
+
+### 1. Using with Ollama
+You can pull and run the models directly via Ollama:
+```bash
+# For fast fixes, common errors, and low RAM usage:
+ollama run hf.co/erdemozkan/YOLO-1.5B-Qwen-Coder
+
+# For complex errors and better reasoning:
+ollama run hf.co/erdemozkan/YOLO-7B-Qwen-Coder
+```
+
+### 2. Using with LM Studio or llama.cpp
+1. Browse to my Hugging Face profile: [erdemozkan](https://huggingface.co/erdemozkan).
+2. Open the model repository (`YOLO-1.5B-Qwen-Coder` or `YOLO-7B-Qwen-Coder`).
+3. Download the `.gguf` file from the "Files" section.
+4. Load the file into LM Studio or run it with your `llama.cpp` server.
+
+| Model | Size | Best for |
+|---|---|---|
+| `YOLO-1.5B-Qwen-Coder` | 1.5B | Fast fixes, common errors, low RAM |
+| `YOLO-7B-Qwen-Coder` | 7B | Complex errors, better reasoning |
+| `qwen2.5-coder:7b` | 7B | Vanilla base model |
+
+Training data: 2,250 error/fix pairs covering Python, Node, npm, TypeScript, Docker, Git, web frameworks, auth, async, CORS, circular imports, and more. Format: ChatML LoRA on Apple Silicon M-series.
+
+---
+
+## Rollback & history
+
+YOLO snapshots every file it touches before making any changes. If a fix fails after 3 attempts, everything is restored automatically.
+
+```bash
+# See what YOLO changed in the last session
+yoco --rollback
+# → numbered list of modified files, pick one or press 'a' to undo all
+
+# See the last 20 runs
+yoco --history
+# → table: date / command / outcome / source (interceptor / memory / LLM)
+
+# See details of run #5
+yoco --history 5
+```
+
+---
+
+## Configuration
+
+YOCO supports **Ollama**, **LM Studio**, and **llama.cpp** out of the box. Config is layered — CLI flags override the saved file, which overrides built-in defaults.
+
+### Config file
+
+```json
+// ~/.yolo/config.json
+{
+  "provider": "ollama",
+  "host": "localhost",
+  "port": 11434,
+  "model": "hf.co/erdemozkan/YOLO-1.5B-Qwen-Coder",
+  "max_attempts": 3,
+  "dry_run": false
+}
+```
+
+### Per-run CLI overrides
+
+```bash
+# Switch provider for one run
+yoco --provider lmstudio python3 myapp.py
+
+# Custom host or port (e.g. Ollama on a remote machine or non-default port)
+yoco --host 192.168.1.50 --port 11434 python3 myapp.py
+
+# Override model for one run
+yoco --model yolo-7b python3 myapp.py
+```
+
+### Provider defaults
+
+| Provider | Default port | Notes |
+|---|---|---|
+| `ollama` | `11434` | `ollama serve` — recommended |
+| `lmstudio` | `1234` | Enable "Local Server" in the LM Studio UI |
+| `llamacpp` | `8080` | `./server -m model.gguf --port 8080` |
+
+### Setting up each provider
+
+**Ollama (recommended)**
+```bash
+ollama serve                                        # start the server
+ollama run hf.co/erdemozkan/YOLO-1.5B-Qwen-Coder  # pull + verify model
+echo '{"provider": "ollama", "model": "hf.co/erdemozkan/YOLO-1.5B-Qwen-Coder"}' > ~/.yolo/config.json
+```
+
+**LM Studio**
+```bash
+# 1. Open LM Studio → Model tab → load any GGUF model
+# 2. Go to Local Server tab → Start Server (enable CORS)
+# 3. Tell YOCO to use it:
+echo '{"provider": "lmstudio"}' > ~/.yolo/config.json
+# LM Studio uses whatever model is currently loaded — no model name needed
+```
+
+**llama.cpp server**
+```bash
+./server -m YOLO-7B-Qwen-q4.gguf --port 8080      # start the server
+echo '{"provider": "llamacpp", "port": 8080}' > ~/.yolo/config.json
+```
+
+**Custom port or remote host**
+```bash
+# Ollama running on a non-default port
+echo '{"provider": "ollama", "host": "localhost", "port": 12345}' > ~/.yolo/config.json
+
+# Ollama on a remote machine on your local network
+echo '{"provider": "ollama", "host": "192.168.1.50", "port": 11434}' > ~/.yolo/config.json
+```
+
+### Check active config
+
+```bash
+yoco --config
+```
+
+---
+
+## Philosophy
+
+Most AI coding tools want to be your pair programmer. YOLO wants to be the intern who quietly fixes the thing that was blocking you so you can keep doing what you were doing.
+
+It runs locally. It doesn't read your whole codebase. It doesn't require an API key. It doesn't post your stack traces to anyone. It doesn't ask for confirmation for the obvious stuff. It just fixes it.
+
+The design priorities, in order:
+
+1. **Speed** — interceptors fire before the LLM even wakes up
+2. **Safety** — nothing is applied without a snapshot; everything is reversible
+3. **Locality** — 100% local inference, no data leaves your machine
+4. **Simplicity** — one command, wraps whatever you were already running
+
+Oh, and while it works, it'll throw out a random quip — "YOLOing..", "Crying..", "Day dreaming.." — just for fun 😄
+
+---
+
+## Roadmap
+
+See [FUTURE_FEATURES.md](FUTURE_FEATURES.md) for deferred ideas with architectural reasoning.
+
+Completed:
+- [x] `--explain` mode — plain-English diff after every fix
+- [x] `--watch` mode — re-runs on every file save
+- [x] `--rollback` — interactive undo picker
+- [x] `--dry-run` — preview fix without applying
+- [x] Fix memory — instant replay of past fixes
+- [x] Security gate — blocks git push when secrets are detected
+- [x] First-run disclaimer with local acceptance record
+
+Near-term:
+- [ ] Rust / cargo error interceptors
+- [ ] Shell script error interceptors (bash -e failures)
+- [ ] VS Code extension (show fix inline before applying)
+- [ ] CI mode (non-interactive, exits 0 on fix, 1 on failure)
+- [ ] `pip install yoco` — publish to PyPI for global install
+- [ ] Lean terminal UI — interactive dashboard while YOCO works
+- [ ] YOCO Web — browser-based interface similar to Claude Code
+
+---
+
+## Contributing
+
+Interceptors are the easiest entry point. Add a function to `core/interceptors.py`, append it to the `INTERCEPTORS` list, add a test case to `tests/tests.json`. See [CLAUDE.md](CLAUDE.md) for the full developer guide.
+
+---
+
+## License
+
+MIT. Do whatever you want with it. If you make a million dollars, consider buying the author a coffee.
+
+---
+
+<div align="center">
+
+**Star it if it saved you from a Stack Overflow rabbit hole.**
+
+*Built on Apple Silicon. Powered by local LLMs. Runs at YOLO speed.*
+
+</div>