fixr-cli 0.1.0__tar.gz

fixr_cli-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+dist/
+build/
+*.egg-info/
+.fixr/
+*.save
+test.py
+test2.py
+script.py

fixr_cli-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: fixr-cli
+Version: 0.1.0
+Summary: AI-powered CLI that explains programming errors using a persistent cache and LLMs.
+Project-URL: Homepage, https://github.com/yourusername/fixr
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: litellm>=1.40.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Description-Content-Type: text/markdown
+
+# fixr ⚡
+
+AI-powered CLI that explains errors and suggests fixes — using a hashtable cache + LLM combo.
+
+## Install
+
+```bash
+pip install fixr
+# or
+uv add fixr
+```
+
+## Usage
+
+```bash
+# Direct
+fixr "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+
+# Pipe any command output
+python script.py 2>&1 | fixr
+cargo build 2>&1 | fixr
+node app.js 2>&1 | fixr
+g++ main.cpp 2>&1 | fixr
+```
+
+## Setup
+
+```bash
+# Set API key
+fixr config --provider groq --api-key gsk_...
+
+# Set default provider
+fixr config --provider gemini
+
+# OAuth login (Google/Gemini)
+fixr login google
+
+# Show current config
+fixr config --show
+
+# List all providers
+fixr providers
+```
+
+## Free tier providers (no credit card)
+
+| Provider | Models |
+|---|---|
+| groq | llama-3.3-70b-versatile |
+| gemini | gemini-2.0-flash |
+| mistral | mistral-small |
+| openrouter | 20+ free models |
+| nvidia | 100+ open models |
+| cerebras | llama3.3-70b |
+
+## How it works
+
+```
+error input
+    │
+    ▼
+normalize + hash (sha256[:16])
+    │
+    ▼
+cache hit? ──yes──→ instant response ⚡
+    │
+   no
+    ▼
+LLM call (provider of choice)
+    │
+    ▼
+store in ~/.fixr/cache.json
+    │
+    ▼
+display fix
+```
+
+Cache lives at `~/.fixr/cache.json`. Gets smarter over time.

fixr_cli-0.1.0/README.md

@@ -0,0 +1,78 @@
+# fixr ⚡
+
+AI-powered CLI that explains errors and suggests fixes — using a hashtable cache + LLM combo.
+
+## Install
+
+```bash
+pip install fixr
+# or
+uv add fixr
+```
+
+## Usage
+
+```bash
+# Direct
+fixr "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+
+# Pipe any command output
+python script.py 2>&1 | fixr
+cargo build 2>&1 | fixr
+node app.js 2>&1 | fixr
+g++ main.cpp 2>&1 | fixr
+```
+
+## Setup
+
+```bash
+# Set API key
+fixr config --provider groq --api-key gsk_...
+
+# Set default provider
+fixr config --provider gemini
+
+# OAuth login (Google/Gemini)
+fixr login google
+
+# Show current config
+fixr config --show
+
+# List all providers
+fixr providers
+```
+
+## Free tier providers (no credit card)
+
+| Provider | Models |
+|---|---|
+| groq | llama-3.3-70b-versatile |
+| gemini | gemini-2.0-flash |
+| mistral | mistral-small |
+| openrouter | 20+ free models |
+| nvidia | 100+ open models |
+| cerebras | llama3.3-70b |
+
+## How it works
+
+```
+error input
+    │
+    ▼
+normalize + hash (sha256[:16])
+    │
+    ▼
+cache hit? ──yes──→ instant response ⚡
+    │
+   no
+    ▼
+LLM call (provider of choice)
+    │
+    ▼
+store in ~/.fixr/cache.json
+    │
+    ▼
+display fix
+```
+
+Cache lives at `~/.fixr/cache.json`. Gets smarter over time.

fixr_cli-0.1.0/fixr/auth.py

@@ -0,0 +1,57 @@
+import webbrowser
+import httpx
+import json
+from pathlib import Path
+from . import config as cfg
+
+# OAuth configs per provider (add more as providers support it)
+OAUTH_CONFIGS = {
+    "google": {
+        "auth_url": "https://accounts.google.com/o/oauth2/v2/auth",
+        "token_url": "https://oauth2.googleapis.com/token",
+        "scope": "https://www.googleapis.com/auth/generative-language",
+        "client_id_env": "GOOGLE_CLIENT_ID",
+        "client_secret_env": "GOOGLE_CLIENT_SECRET",
+    }
+}
+
+def set_api_key(provider: str, key: str) -> None:
+    cfg.set_key(provider, key)
+
+def get_api_key(provider: str) -> str | None:
+    return cfg.get_key(provider)
+
+def oauth_login(provider: str) -> str | None:
+    """
+    Opens browser for OAuth flow. Returns access token or None.
+    Currently supports: google (Gemini)
+    """
+    import os
+    oc = OAUTH_CONFIGS.get(provider)
+    if not oc:
+        raise ValueError(f"OAuth not supported for provider: {provider}")
+
+    client_id = os.environ.get(oc["client_id_env"])
+    if not client_id:
+        raise ValueError(f"Set {oc['client_id_env']} env var to use OAuth for {provider}")
+
+    # Build auth URL (device flow simplified)
+    params = {
+        "client_id": client_id,
+        "response_type": "code",
+        "scope": oc["scope"],
+        "redirect_uri": "urn:ietf:wg:oauth:2.0:oob",
+        "access_type": "offline",
+    }
+    from urllib.parse import urlencode
+    url = f"{oc['auth_url']}?{urlencode(params)}"
+    webbrowser.open(url)
+    return url  # User pastes code manually in CLI
+
+def save_oauth_token(provider: str, token: str) -> None:
+    c = cfg.load()
+    c.setdefault("auth_tokens", {})[provider] = token
+    cfg.save(c)
+
+def get_oauth_token(provider: str) -> str | None:
+    return cfg.load().get("auth_tokens", {}).get(provider)

fixr_cli-0.1.0/fixr/cache.py

@@ -0,0 +1,42 @@
+import json
+import hashlib
+from pathlib import Path
+from .config import FIXR_DIR
+
+CACHE_FILE = FIXR_DIR / "cache.json"
+
+def _normalize(error: str) -> str:
+    """Strip line numbers and memory addresses for stable cache keys."""
+    import re
+    s = re.sub(r'line \d+', 'line N', error)
+    s = re.sub(r'0x[0-9a-fA-F]+', '0xADDR', s)
+    s = re.sub(r'\s+', ' ', s).strip().lower()
+    return s
+
+def _key(error: str) -> str:
+    return hashlib.sha256(_normalize(error).encode()).hexdigest()[:16]
+
+def _load() -> dict:
+    FIXR_DIR.mkdir(exist_ok=True)
+    if not CACHE_FILE.exists():
+        return {}
+    try:
+        return json.loads(CACHE_FILE.read_text())
+    except Exception:
+        return {}
+
+def _save(cache: dict) -> None:
+    CACHE_FILE.write_text(json.dumps(cache, indent=2))
+
+def get(error: str) -> str | None:
+    return _load().get(_key(error))
+
+def set(error: str, solution: str) -> None:
+    cache = _load()
+    cache[_key(error)] = solution
+    _save(cache)
+
+def clear() -> int:
+    count = len(_load())
+    _save({})
+    return count

fixr_cli-0.1.0/fixr/config.py

@@ -0,0 +1,61 @@
+import json
+from pathlib import Path
+
+FIXR_DIR = Path.home() / ".fixr"
+CONFIG_FILE = FIXR_DIR / "config.json"
+
+DEFAULTS = {
+    "provider": "groq",
+    "model": "groq/llama-3.3-70b-versatile",
+    "api_keys": {},
+    "auth_tokens": {},
+}
+
+def load() -> dict:
+    FIXR_DIR.mkdir(exist_ok=True)
+    if not CONFIG_FILE.exists():
+        save(DEFAULTS.copy())
+        return DEFAULTS.copy()
+    return json.loads(CONFIG_FILE.read_text())
+
+def save(cfg: dict) -> None:
+    FIXR_DIR.mkdir(exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(cfg, indent=2))
+
+def set_key(provider: str, key: str) -> None:
+    cfg = load()
+    cfg["api_keys"][provider] = key
+    save(cfg)
+
+def get_key(provider: str) -> str | None:
+    cfg = load()
+    return cfg["api_keys"].get(provider)
+
+def set_default(provider: str, model: str) -> None:
+    cfg = load()
+    cfg["provider"] = provider
+    cfg["model"] = model
+    save(cfg)
+def get_models(provider: str) -> list:
+    cfg = load()
+    defaults = {
+        "groq":       ["groq/llama-3.3-70b-versatile", "groq/llama-3.1-8b-instant", "groq/mixtral-8x7b-32768"],
+        "gemini":     ["gemini/gemini-2.0-flash", "gemini/gemini-2.5-pro", "gemini/gemini-1.5-pro"],
+        "mistral":    ["mistral/mistral-small-latest", "mistral/mistral-large-latest", "mistral/codestral-latest"],
+        "openai":     ["openai/gpt-4o-mini", "openai/gpt-4o", "openai/o4-mini"],
+        "anthropic":  ["anthropic/claude-haiku-4-5-20251001", "anthropic/claude-sonnet-4-6", "anthropic/claude-opus-4-6"],
+        "openrouter": ["openrouter/meta-llama/llama-3.3-70b-instruct:free", "openrouter/mistralai/mistral-7b-instruct:free", "openrouter/google/gemma-3-27b-it:free"],
+        "cerebras":   ["cerebras/llama-3.3-70b", "cerebras/llama-3.1-8b", "cerebras/llama-3.1-70b"],
+        "nvidia":     ["nvidia_nim/meta/llama-3.3-70b-instruct", "nvidia_nim/mistralai/mistral-7b-instruct-v0.3", "nvidia_nim/google/gemma-3-27b-it"],
+        "ollama":     ["ollama/llama3.3", "ollama/mistral", "ollama/codellama"],
+        "cohere":     ["cohere/command-r-plus", "cohere/command-r", "cohere/command-a-03-2025"],
+    }
+    custom = cfg.get("custom_models", {}).get(provider, [])
+    return defaults.get(provider, []) + custom
+
+def add_model(provider: str, model: str) -> None:
+    cfg = load()
+    cfg.setdefault("custom_models", {}).setdefault(provider, [])
+    if model not in cfg["custom_models"][provider]:
+        cfg["custom_models"][provider].append(model)
+    save(cfg)

fixr_cli-0.1.0/fixr/llm.py

@@ -0,0 +1,91 @@
+import os
+from . import config as cfg
+
+PROVIDER_MODELS = {
+    "groq":       "groq/llama-3.3-70b-versatile",
+    "gemini":     "gemini/gemini-2.0-flash",
+    "mistral":    "mistral/mistral-small-latest",
+    "openai":     "openai/gpt-4o-mini",
+    "anthropic":  "anthropic/claude-haiku-4-5-20251001",
+    "ollama":     "ollama/llama3",
+    "openrouter": "openrouter/meta-llama/llama-3.3-70b-instruct:free",
+    "nvidia":     "nvidia_nim/meta/llama-3.3-70b-instruct",
+    "cerebras":   "cerebras/llama3.3-70b",
+    "cohere":     "cohere/command-r-plus",
+}
+
+PROVIDER_ENV_KEYS = {
+    "groq":       "GROQ_API_KEY",
+    "gemini":     "GEMINI_API_KEY",
+    "mistral":    "MISTRAL_API_KEY",
+    "openai":     "OPENAI_API_KEY",
+    "anthropic":  "ANTHROPIC_API_KEY",
+    "openrouter": "OPENROUTER_API_KEY",
+    "nvidia":     "NVIDIA_NIM_API_KEY",
+    "cerebras":   "CEREBRAS_API_KEY",
+    "cohere":     "COHERE_API_KEY",
+}
+
+PROMPT = """\
+You are a senior software engineer. Analyze the error below. Be precise, technical, and concise.
+
+Respond in EXACTLY this format — no extra text, no deviation:
+
+ERROR TYPE: <NameError | TypeError | SyntaxError | ImportError | RuntimeError | LogicError | Other>
+SEVERITY: <Critical | High | Medium | Low>
+
+EXPLANATION:
+<2 sentences max. Name the exact variable, line, or function. Say WHY it failed, not just what failed.>
+
+ROOT CAUSE:
+<1 sentence. The single deepest technical reason.>
+
+FIX:
+```python
+<minimal working code that fixes the issue>
+```
+
+PREVENTION:
+<1 sentence. Actionable rule. Start with "Always" or "Never".>
+
+ERROR:
+{error}
+"""
+
+def resolve_key(provider: str) -> str | None:
+    """Check config store first, then env var."""
+    key = cfg.get_key(provider)
+    if key:
+        return key
+    env = PROVIDER_ENV_KEYS.get(provider)
+    return os.environ.get(env) if env else None
+
+def _set_env_key(provider: str, key: str) -> None:
+    env = PROVIDER_ENV_KEYS.get(provider)
+    if env and key:
+        os.environ[env] = key
+
+def ask(error: str, provider: str | None = None, model: str | None = None) -> str:
+    from litellm import completion
+
+    conf = cfg.load()
+    provider = provider or conf.get("provider", "groq")
+    model = model or conf.get("model") or PROVIDER_MODELS.get(provider, "groq/llama-3.3-70b-versatile")
+
+    key = resolve_key(provider)
+    if not key:
+        raise ValueError(
+            f"No API key found for '{provider}'.\n"
+            f"Run: fxr config --provider {provider} --api-key YOUR_KEY\n"
+            f"Or:  fxr setup"
+        )
+    _set_env_key(provider, key)
+
+
+
+    resp = completion(
+        model=model,
+        messages=[{"role": "user", "content": PROMPT.format(error=error.strip())}],
+        max_tokens=600,
+    )
+    return resp.choices[0].message.content.strip()

fixr_cli-0.1.0/fixr/main.py

@@ -0,0 +1,221 @@
+import sys
+import subprocess
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.panel import Panel
+
+from . import cache, llm, auth, config as cfg
+from .llm import PROVIDER_MODELS
+
+app = typer.Typer(help="fixr — AI error explainer with smart caching")
+console = Console()
+
+
+def _read_stdin() -> str | None:
+    if not sys.stdin.isatty():
+        return sys.stdin.read().strip()
+    return None
+
+def _run_fix(err: str, provider=None, model=None, no_cache=False):
+    if not no_cache:
+        cached = cache.get(err)
+        if cached:
+            _display(cached, cached=True)
+            return
+    with console.status("[cyan]Analyzing error...[/cyan]"):
+        try:
+            solution = llm.ask(err, provider=provider, model=model)
+        except ValueError as e:
+            console.print(f"[bold red]✗ Config error:[/bold red] {e}")
+            raise typer.Exit(1)
+        except Exception as e:
+            console.print(f"[bold red]✗ LLM error:[/bold red] {e}")
+            raise typer.Exit(1)
+
+
+def _display(solution: str, cached: bool = False):
+    from rich.syntax import Syntax
+    from rich.rule import Rule
+    import re
+
+    title = "[green]fixr ⚡ cached[/green]" if cached else "[cyan]fixr[/cyan]"
+    console.print()
+    console.rule(f"[bold]{title}[/bold]")
+
+    # Extract and style each section
+    sections = {
+        "ERROR TYPE": "bold red",
+        "SEVERITY": "bold yellow",
+        "EXPLANATION": "white",
+        "ROOT CAUSE": "bold white",
+        "FIX": None,  # handled separately for code
+        "PREVENTION": "green",
+    }
+
+    current = solution
+    for section, style in sections.items():
+        pattern = rf"{section}:\n?(.*?)(?=\n[A-Z ]+:|$)"
+        match = re.search(pattern, current, re.DOTALL)
+        if not match:
+            continue
+        content = match.group(1).strip()
+
+        if section == "FIX":
+            console.print(f"\n[bold cyan]● FIX[/bold cyan]")
+            # extract code block
+            code_match = re.search(r"```(?:\w+)?\n?(.*?)```", content, re.DOTALL)
+            if code_match:
+                code = code_match.group(1).strip()
+                syntax = Syntax(code, "python", theme="dracula", line_numbers=True)
+                console.print(syntax)
+            else:
+                console.print(content)
+        elif section in ("ERROR TYPE", "SEVERITY"):
+            console.print(f"[{style}]{section}:[/{style}] {content}")
+        else:
+            console.print(f"\n[bold cyan]● {section}[/bold cyan]")
+            console.print(f"[{style}]{content}[/{style}]")
+
+    console.rule()
+    console.print()
+
+@app.callback(invoke_without_command=True)
+def main(ctx: typer.Context):
+    """fixr — paste an error or a script file, get a fix."""
+    if ctx.invoked_subcommand is not None:
+        return
+
+    stdin_error = _read_stdin()
+    if stdin_error:
+        _run_fix(stdin_error)
+        return
+    console.print("[yellow]Usage: fxr 'error message'  or  fxr script.py[/yellow]")
+
+@app.command(name="fix", help="Explain an error and suggest a fix.")
+def fix(
+    error: str = typer.Argument(None, help="Error string to analyze"),
+    provider: str = typer.Option(None, "--provider", "-p", help="LLM provider"),
+    model: str = typer.Option(None, "--model", "-m", help="Model string"),
+    no_cache: bool = typer.Option(False, "--no-cache", help="Skip cache lookup"),
+):
+    stdin_error = _read_stdin()
+    err = stdin_error or error
+    if not err:
+        err = typer.prompt("Paste your error")
+    _run_fix(err, provider=provider, model=model, no_cache=no_cache)
+
+
+@app.command()
+def config(
+    provider: str = typer.Option(None, "--provider", "-p", help="Set default provider"),
+    model: str = typer.Option(None, "--model", "-m", help="Set default model"),
+    api_key: str = typer.Option(None, "--api-key", "-k", help="Set API key for provider"),
+    show: bool = typer.Option(False, "--show", help="Show current config"),
+):
+    """Configure default provider, model, and API keys."""
+    if show:
+        c = cfg.load()
+        keys = {k: v[:8] + "..." for k, v in c.get("api_keys", {}).items() if v}
+        console.print(Panel(
+            f"Provider: [cyan]{c.get('provider')}[/cyan]\n"
+            f"Model:    [cyan]{c.get('model')}[/cyan]\n"
+            f"Keys:     {keys}",
+            title="fixr config"
+        ))
+        return
+    if api_key and provider:
+        auth.set_api_key(provider, api_key)
+        console.print(f"[green]✓[/green] API key saved for [cyan]{provider}[/cyan]")
+    if provider or model:
+        p = provider or cfg.load().get("provider", "groq")
+        m = model or PROVIDER_MODELS.get(p, "groq/llama-3.3-70b-versatile")
+        cfg.set_default(p, m)
+        console.print(f"[green]✓[/green] Default set to [cyan]{p}[/cyan] / [cyan]{m}[/cyan]")
+
+
+@app.command()
+def login(
+    provider: str = typer.Argument(..., help="Provider to OAuth login (e.g. google)"),
+):
+    """Login via OAuth (browser-based). Currently supports: google."""
+    try:
+        url = auth.oauth_login(provider)
+        console.print(f"[cyan]Browser opened.[/cyan] If not, visit:\n{url}")
+        code = typer.prompt("Paste the auth code here")
+        auth.save_oauth_token(provider, code)
+        console.print(f"[green]✓[/green] Token saved for [cyan]{provider}[/cyan]")
+    except ValueError as e:
+        console.print(f"[red]{e}[/red]")
+        raise typer.Exit(1)
+
+
+@app.command()
+def providers():
+    """List all supported providers and their default models."""
+    console.print("\n[bold]Supported Providers[/bold]\n")
+    free = {"groq", "gemini", "mistral", "openrouter", "nvidia", "cerebras"}
+    for p, m in PROVIDER_MODELS.items():
+        tier = "[green]free tier[/green]" if p in free else "[yellow]paid[/yellow]"
+        console.print(f"  [cyan]{p:<12}[/cyan] {tier:<20} {m}")
+    console.print()
+
+
+@app.command()
+def clear_cache():
+    """Clear the local error cache."""
+    n = cache.clear()
+    console.print(f"[green]✓[/green] Cleared {n} cached entries.")
+
+
+@app.command()
+def setup():
+    """Interactive setup wizard."""
+    console.print("\n[bold cyan]fxr setup[/bold cyan]\n")
+
+    providers_list = list(PROVIDER_MODELS.keys())
+    free = {"groq", "gemini", "mistral", "openrouter", "cerebras", "ollama", "nvidia"}
+    for i, p in enumerate(providers_list):
+        tier = "[green]free[/green]" if p in free else "[yellow]paid[/yellow]"
+        console.print(f"  {i+1}. {p} ({tier})")
+
+    choice = typer.prompt("\nSelect provider number", default="1")
+    provider = providers_list[int(choice) - 1]
+
+    models = cfg.get_models(provider)
+    console.print(f"\n[bold]Models for {provider}:[/bold]")
+    for i, m in enumerate(models):
+        console.print(f"  {i+1}. {m}")
+    console.print(f"  {len(models)+1}. Enter custom model")
+
+    mchoice = typer.prompt("Select model number", default="1")
+    midx = int(mchoice) - 1
+    if midx == len(models):
+        model = typer.prompt("Enter model string")
+        cfg.add_model(provider, model)
+    else:
+        model = models[midx]
+
+    api_key = typer.prompt(f"\nPaste your {provider} API key", hide_input=True)
+    auth.set_api_key(provider, api_key)
+    cfg.set_default(provider, model)
+    console.print(f"\n[green]✓[/green] Config saved — {provider} / {model}")
+    console.print("\n[bold #50fa7b]✓ Setup complete! Run: fxr \"your error\" or fxr script.py[/bold #50fa7b]")
+
+
+@app.command(name="add-model")
+def add_model_cmd(
+    provider: str = typer.Argument(..., help="Provider name"),
+    model: str = typer.Argument(..., help="Model string"),
+):
+    """Add a custom model to a provider's list."""
+    cfg.add_model(provider, model)
+    console.print(f"[green]✓[/green] Added [cyan]{model}[/cyan] to [cyan]{provider}[/cyan]")
+
+def cli():
+    known = {"fix", "config", "login", "providers", "clear-cache", "setup", "add-model", "--help", "-h"}
+    if len(sys.argv) > 1 and sys.argv[1] not in known and not sys.argv[1].startswith("--"):
+        sys.argv.insert(1, "fix")
+    app()

fixr_cli-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fixr-cli"
+version = "0.1.0"
+description = "AI-powered CLI that explains programming errors using a persistent cache and LLMs."
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "typer>=0.12.0",
+    "litellm>=1.40.0",
+    "httpx>=0.27.0",
+    "rich>=13.0.0",
+]
+
+[project.scripts]
+fxr = "fixr.main:cli"
+fixr = "fixr.main:cli"
+
+[project.urls]
+Homepage = "https://github.com/yourusername/fixr"