envfix 0.4.0__tar.gz

envfix-0.4.0/LICENSE

@@ -0,0 +1,91 @@
+Business Source License 1.1
+
+Licensor:             LOVE KUSH KUMHAR
+Licensed Work:        envfix (the "Licensed Work")
+                      The Licensed Work is (c) 2026 LOVE KUSH KUMHAR
+
+Additional Use Grant: You may use, copy, modify, and redistribute
+                      the Licensed Work for any purpose, including
+                      commercial use, EXCEPT that you may not offer
+                      the Licensed Work, or any modified or derivative
+                      version of it, to third parties as a hosted or
+                      managed service (for example, a paid or free
+                      cloud-based version of envfix that performs
+                      the same core function of diagnosing and
+                      fixing environment errors on behalf of users
+                      who do not run the software themselves).
+
+                      Running envfix locally, integrating it into
+                      your own development workflow, or using it
+                      within your own company for internal purposes
+                      is fully permitted, including at commercial
+                      organizations, at no cost.
+
+Change Date:          July 26, 2029
+
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements
+(e.g., to offer envfix as a hosted service), contact:
+lovekushkumhar64@gmail.com
+
+---
+
+Notice
+
+The Business Source License (this document, or the "License") is
+not an Open Source license. However, the Licensed Work will
+eventually be made available under an Open Source License, as
+stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights
+Reserved. "Business Source License" is a trademark of MariaDB
+Corporation Ab.
+
+-----------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create
+derivative works, redistribute, and make non-production use of
+the Licensed Work. The Licensor may make an Additional Use Grant,
+above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the
+first publicly available distribution of a specific version of
+the Licensed Work under this License, whichever comes first, the
+Licensor hereby grants you rights under the terms of the Change
+License, and the rights granted in the paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the
+requirements currently in effect as described in this License,
+you must purchase a commercial license from the Licensor, its
+affiliated entities, or authorized resellers, or you must refrain
+from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and
+derivative works of the Licensed Work, are subject to this
+License. This License applies separately for each version of
+the Licensed Work and the Change Date may vary for each version
+of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or
+modified copy of the Licensed Work. If you receive the Licensed
+Work in original or modified form from a third party, the terms
+and conditions set forth in this License apply to your use of
+that work.
+
+Any use of the Licensed Work in violation of this License will
+automatically terminate your rights under this License for the
+current and all other versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or
+logo of Licensor or its affiliates (provided that you may use a
+trademark or logo of Licensor as expressly required by this
+License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS
+PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL
+WARRANTIES AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT
+LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE, NON-INFRINGEMENT, AND TITLE.

envfix-0.4.0/PKG-INFO

@@ -0,0 +1,450 @@
+Metadata-Version: 2.4
+Name: envfix
+Version: 0.4.0
+Summary: CLI tool that diagnoses and auto-fixes Python/ML environment errors using a local LLM.
+License: Business Source License 1.1
+        
+        Licensor:             LOVE KUSH KUMHAR
+        Licensed Work:        envfix (the "Licensed Work")
+                              The Licensed Work is (c) 2026 LOVE KUSH KUMHAR
+        
+        Additional Use Grant: You may use, copy, modify, and redistribute
+                              the Licensed Work for any purpose, including
+                              commercial use, EXCEPT that you may not offer
+                              the Licensed Work, or any modified or derivative
+                              version of it, to third parties as a hosted or
+                              managed service (for example, a paid or free
+                              cloud-based version of envfix that performs
+                              the same core function of diagnosing and
+                              fixing environment errors on behalf of users
+                              who do not run the software themselves).
+        
+                              Running envfix locally, integrating it into
+                              your own development workflow, or using it
+                              within your own company for internal purposes
+                              is fully permitted, including at commercial
+                              organizations, at no cost.
+        
+        Change Date:          July 26, 2029
+        
+        Change License:       Apache License, Version 2.0
+        
+        For information about alternative licensing arrangements
+        (e.g., to offer envfix as a hosted service), contact:
+        lovekushkumhar64@gmail.com
+        
+        ---
+        
+        Notice
+        
+        The Business Source License (this document, or the "License") is
+        not an Open Source license. However, the Licensed Work will
+        eventually be made available under an Open Source License, as
+        stated in this License.
+        
+        License text copyright (c) 2017 MariaDB Corporation Ab, All Rights
+        Reserved. "Business Source License" is a trademark of MariaDB
+        Corporation Ab.
+        
+        -----------------------------------------------------------------
+        
+        Terms
+        
+        The Licensor hereby grants you the right to copy, modify, create
+        derivative works, redistribute, and make non-production use of
+        the Licensed Work. The Licensor may make an Additional Use Grant,
+        above, permitting limited production use.
+        
+        Effective on the Change Date, or the fourth anniversary of the
+        first publicly available distribution of a specific version of
+        the Licensed Work under this License, whichever comes first, the
+        Licensor hereby grants you rights under the terms of the Change
+        License, and the rights granted in the paragraph above terminate.
+        
+        If your use of the Licensed Work does not comply with the
+        requirements currently in effect as described in this License,
+        you must purchase a commercial license from the Licensor, its
+        affiliated entities, or authorized resellers, or you must refrain
+        from using the Licensed Work.
+        
+        All copies of the original and modified Licensed Work, and
+        derivative works of the Licensed Work, are subject to this
+        License. This License applies separately for each version of
+        the Licensed Work and the Change Date may vary for each version
+        of the Licensed Work released by Licensor.
+        
+        You must conspicuously display this License on each original or
+        modified copy of the Licensed Work. If you receive the Licensed
+        Work in original or modified form from a third party, the terms
+        and conditions set forth in this License apply to your use of
+        that work.
+        
+        Any use of the Licensed Work in violation of this License will
+        automatically terminate your rights under this License for the
+        current and all other versions of the Licensed Work.
+        
+        This License does not grant you any right in any trademark or
+        logo of Licensor or its affiliates (provided that you may use a
+        trademark or logo of Licensor as expressly required by this
+        License).
+        
+        TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS
+        PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL
+        WARRANTIES AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT
+        LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+        PURPOSE, NON-INFRINGEMENT, AND TITLE.
+        
+Project-URL: Homepage, https://github.com/LOVEKUSH-rgb/deepproblemsolver
+Project-URL: Repository, https://github.com/LOVEKUSH-rgb/deepproblemsolver
+Project-URL: Bug Tracker, https://github.com/LOVEKUSH-rgb/deepproblemsolver/issues
+Keywords: cli,llm,ollama,python,environment,debugging
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Debuggers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.12
+Requires-Dist: ollama>=0.2
+Requires-Dist: groq>=0.9.0
+Requires-Dist: google-genai>=0.1.0
+Requires-Dist: tomli>=2.0.1; python_version < "3.11"
+Requires-Dist: tomli-w>=1.0.0
+Dynamic: license-file
+
+# envfix 🛠️
+
+> **`envfix` wraps any failing shell command, asks a local AI model what went wrong, and proposes a one-click fix — fully offline, no API key, no cloud.**
+
+```
+without envfix                          with envfix
+──────────────────────────────────────  ──────────────────────────────────────────
+$ python train.py                       $ envfix run python train.py
+
+ModuleNotFoundError:                    ✗ Command Failed
+  No module named 'torch'              │ ModuleNotFoundError: No module named 'torch'
+
+↓ Google the error                      🤖 Asking Ollama (llama3.1:8b)…
+↓ Stack Overflow rabbit hole
+↓ Try three different pip commands      ╭─────────── envfix Suggestion ────────────╮
+↓ Wrong CUDA version                    │ DIAGNOSIS                                │
+↓ Try again                             │ PyTorch is not installed in this env.    │
+                                        │                                          │
+~20 minutes later:                      │ FIX                                      │
+$ python -m pip install torch           │ python -m pip install torch              │
+                                        ╰──────────────────────────────────────────╯
+
+                                        Run this fix? [y/n] (n): y
+                                        ✓ Success! The fix resolved the issue.
+                                        (total time: ~30 seconds)
+```
+
+> ⚠️ **Early / experimental.** Works best for common Python, Node.js, and
+> package-manager errors. See [Known limitations](#known-limitations).
+
+---
+
+## Prerequisites
+
+| Requirement | Version | Why |
+|---|---|---|
+| Python | ≥ 3.10 | f-strings, match syntax |
+| [Ollama](https://ollama.com/download) | latest | (Optional) runs the local AI model |
+| API Keys | | (Optional) `GROQ_API_KEY` or `GEMINI_API_KEY` for cloud models |
+| RAM | ≥ 8 GB | for local `llama3.1:8b` — or ≥ 4 GB for `qwen2.5:3b` |
+
+---
+
+## Install
+
+### Step 1 — Choose your AI provider
+
+`envfix` supports local and cloud models. 
+
+**Option A (Default): Local Ollama**
+Download from **[ollama.com/download](https://ollama.com/download)** (Windows, macOS, Linux).
+
+On Linux you can also run:
+```bash
+curl -fsSL https://ollama.com/install.sh | sh
+```
+
+### Step 2 — Pull a model
+
+```bash
+# Recommended (needs ~8 GB RAM free)
+ollama pull llama3.1:8b
+
+# Lighter alternatives if you have ≤ 4 GB free RAM
+ollama pull qwen2.5:3b
+ollama pull llama3.2:3b
+```
+
+**Option B: Groq API (Cloud)**
+1. Get a free API key from [console.groq.com](https://console.groq.com/).
+2. Set it in your terminal:
+   ```bash
+   # Windows PowerShell
+   $env:GROQ_API_KEY="your-key-here"
+   # Linux/macOS
+   export GROQ_API_KEY="your-key-here"
+   ```
+
+**Option C: Gemini API (Cloud)**
+1. Get a free API key from [Google AI Studio](https://aistudio.google.com/).
+2. Set it in your terminal:
+   ```bash
+   # Windows PowerShell
+   $env:GEMINI_API_KEY="your-key-here"
+   # Linux/macOS
+   export GEMINI_API_KEY="your-key-here"
+   ```
+
+### Step 3 — Start Ollama
+
+```bash
+ollama serve
+```
+
+> **Windows tip:** The Ollama installer adds a system-tray icon that starts the
+> service automatically on login — you may be able to skip this step.
+> *(Skip this step if you are using Groq or Gemini).*
+
+### Step 4 — Install envfix
+
+```bash
+git clone https://github.com/LOVEKUSH-rgb/deepproblemsolver.git
+cd deepproblemsolver
+pip install -e .
+```
+
+> **Why `-e`?** Editable mode means changes to the source code take effect
+> immediately without reinstalling. For a "permanent" install just use
+> `pip install .` instead.
+
+Verify the install:
+```bash
+envfix --help
+```
+
+---
+
+## Usage
+
+```
+envfix run <your failing command>
+```
+
+### Common examples
+
+```bash
+# Missing Python module
+envfix run python -m non_existent_module
+
+# Broken requirements file
+envfix run python -m pip install -r requirements.txt
+
+# Node / npm error
+envfix run npm run build --category node
+
+# CUDA / GPU error
+envfix run python train.py --gpu 0
+
+# Use a lighter model on a low-RAM machine
+envfix run python train.py --model qwen2.5:3b
+
+# Use a cloud provider instead of local Ollama
+envfix run npm install --provider groq
+envfix run npm install --provider gemini
+
+# Check your fix history
+envfix history
+envfix history --last 5
+```
+
+### What you'll see
+
+```
+▶ Running: python -m pip install -r requirements.txt
+
+╭──────────── ✗ Command Failed ────────────╮
+│ ERROR: Could not find a version that     │
+│ satisfies the requirement bogus-pkg      │
+╰──────────────────────────────────────────╯
+
+🤖 Asking Ollama (llama3.1:8b) for a diagnosis…
+
+╭────────── envfix Suggestion ─────────────╮
+│ DIAGNOSIS                                │
+│ The package 'bogus-pkg' does not exist   │
+│ on PyPI.                                 │
+│                                          │
+│ FIX                                      │
+│ python -m pip install <correct-name>     │
+╰──────────────────────────────────────────╯
+
+📋 What this will do: Installs a package from PyPI
+
+Run this fix? [y/n] (n): y
+```
+
+If the same (or very similar) error has appeared before, `envfix` skips the
+model call entirely and shows the cached suggestion instead:
+
+```
+⚡ Found a previously verified fix (97% match) — skipping model call.
+```
+
+If the suggested fix contains a destructive command (`rm -rf`, `sudo`,
+`delete`, etc.), `envfix` shows an explicit warning and requires you to type
+`yes` in full:
+
+```
+⚠️ DANGEROUS COMMAND DETECTED
+This command may delete files, change permissions, or execute remote code.
+Type 'yes' to run this fix (no):
+```
+
+### Command reference
+
+| Command | What it does |
+|---|---|
+| `envfix run <cmd>` | Run a command; diagnose + suggest fix on failure |
+| `envfix run <cmd> --provider <name>` | Select AI provider (`ollama` [default], `groq`, `gemini`) |
+| `envfix run <cmd> --model <tag>` | Use a specific model tag/name for the chosen provider |
+| `envfix run <cmd> --category <eco>` | Hint the ecosystem (`python`, `node`, `docker` …) |
+| `envfix history` | Show the last 20 attempts |
+| `envfix history --last N` | Show last N attempts |
+
+---
+
+## How it works
+
+```
+envfix run <cmd>
+     │
+     ▼
+ subprocess: run the command, capture stderr
+     │
+  succeeded? ──Yes──► ✓ Nothing to fix
+     │
+    No
+     ▼
+ Check per-user log (envfix_log_<username>.json) for similar past error
+     │
+  Cache hit ──Yes──► Show cached fix (skip Ollama)
+     │
+    No
+     ▼
+ Build structured prompt → POST to local Ollama service
+     │
+     ▼
+ Parse DIAGNOSIS + FIX from model response
+     │
+     ▼
+ Dry-run description for non-obvious commands
+ Destructive guard for dangerous commands (requires "yes" in full)
+     │
+     ▼
+ User approves → apply fix → re-run original command
+     │
+     ▼
+ Log result to envfix_log_<username>.json
+```
+
+---
+
+## Per-user history
+
+Every attempt is logged to `envfix_log_<username>.json` in the directory where
+you run `envfix`. Each user on the same machine gets their own separate file —
+no shared state, no accounts.
+
+The file is excluded from git by `.gitignore` so your personal history never
+gets committed.
+
+Sample entry:
+```json
+{
+  "timestamp": "2026-07-26T08:00:00Z",
+  "original_command": "python train.py",
+  "error_text": "ModuleNotFoundError: No module named 'torch'",
+  "diagnosis": "PyTorch is not installed in this environment.",
+  "fix_command": "python -m pip install torch",
+  "user_approved": true,
+  "fix_worked": true,
+  "source": "ollama",
+  "category": "python",
+  "context_included": false,
+  "provider": "ollama"
+}
+```
+
+---
+
+## Known limitations
+
+- **Model quality varies.** `envfix` is only as good as the local model you
+  pull. Smaller models (`qwen2.5:3b`, `llama3.2:3b`) sometimes produce vague
+  or wrong diagnoses for complex errors. `llama3.1:8b` is the recommended
+  minimum.
+- **Works best for common errors.** Highly project-specific errors (e.g. a bug
+  in your custom C extension) will likely produce generic suggestions.
+- **Windows path assumptions.** The tool normalises `pip install` →
+  `python -m pip install` because `pip` is often not on the Windows PATH. On
+  macOS/Linux both forms work but the normalisation is harmless.
+- **Single fix per failure.** `envfix` proposes one fix at a time. If the
+  first fix doesn't work, run `envfix run <cmd>` again — the model may suggest
+  something different.
+- **Needs Ollama running.** If `ollama serve` is not active, `envfix` exits
+  with a clear error message rather than a cryptic timeout.
+- **Still early.** Prompt engineering and cache fuzzy-matching were tuned for
+  Python/ML and Node errors. Other ecosystems (Rust, Docker, CMake …) will
+  work but with less accuracy.
+
+---
+
+## Running the tests
+
+```bash
+# No Ollama needed — all tests are offline
+python -m pytest tests/ -v
+```
+
+67 tests across three files covering the AI parser, subprocess runner, JSON
+logger, two-tier cache, dry-run preview, safety guardrails, and per-category
+matching.
+
+---
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `Error reaching Ollama: Connection refused` | Run `ollama serve` in a separate terminal |
+| `model "llama3.1:8b" not found` | Run `ollama pull llama3.1:8b` |
+| `envfix: command not found` | Run `pip install -e .` from the repo root |
+| Fix runs but original still fails | The model diagnosis was wrong — run again or fix manually |
+| Model returns garbled output | Try `--model qwen2.5:3b` |
+| Always shows cached (wrong) fix | Cache threshold is 0.85; if the fix is wrong, say `n` and re-run — Ollama will be called fresh |
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the module map, ground rules, and
+how to submit a fix.
+
+---
+
+## License
+
+This project is licensed under the Business Source License 1.1 (BSL 1.1). 
+It requires a commercial license for enterprise/managed service use. 
+See the [LICENSE](LICENSE) file for complete details.