dbgagent 0.1.0__tar.gz

dbgagent-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: dbgagent
+Version: 0.1.0
+Summary: AI-powered Python debugger — run a broken script, get root cause, explanation, and fix
+Author: Aryan Tyagi
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aryantyagi2211/Debug_agent
+Project-URL: Issues, https://github.com/aryantyagi2211/Debug_agent/issues
+Keywords: debugger,python,ai,llm,groq
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: groq
+Requires-Dist: python-dotenv
+Requires-Dist: rich
+
+# Debug_agent
+
+AI-powered Python debugger. Run a broken script, get a structured diagnosis with root cause, explanation, and proposed fix.
+
+## Install
+
+```bash
+pip install debugagent
+```
+
+## Setup
+
+Create a `.env` file in your project folder:
+
+```
+GROQ_API_KEY=your_groq_api_key_here
+```
+
+Get a free API key at [console.groq.com](https://console.groq.com).
+
+## Usage
+
+```bash
+debugagent run brokenscript.py
+```
+
+That's it. It will:
+1. Run your script and capture the error
+2. Read the source code around the error
+3. Check requirements.txt and git diff
+4. Send everything to an LLM and return a structured diagnosis
+
+## Example
+
+```
+$ debugagent run brokenscript.py
+
+Running: brokenscript.py
+
+Script failed (exit 1)
+
+╭─────────────── Traceback ───────────────╮
+│ Traceback (most recent call last):      │
+│   File "brokenscript.py", line 1        │
+│     import nonexistent_module           │
+│ ModuleNotFoundError: ...                │
+╰─────────────────────────────────────────╯
+
+Analyzing with LLM...
+
+╭─────────────── Root Cause ──────────────╮
+│ The module does not exist               │
+╰─────────────────────────────────────────╯
+╭─────────────── Explanation ─────────────╮
+│ The import statement references a       │
+│ module that is not installed...         │
+╰─────────────────────────────────────────╯
+╭─────────────── Proposed Fix ────────────╮
+│ Install the module or remove the import │
+╰─────────────────────────────────────────╯
+```
+
+## License
+
+MIT

dbgagent-0.1.0/README.md

@@ -0,0 +1,65 @@
+# Debug_agent
+
+AI-powered Python debugger. Run a broken script, get a structured diagnosis with root cause, explanation, and proposed fix.
+
+## Install
+
+```bash
+pip install debugagent
+```
+
+## Setup
+
+Create a `.env` file in your project folder:
+
+```
+GROQ_API_KEY=your_groq_api_key_here
+```
+
+Get a free API key at [console.groq.com](https://console.groq.com).
+
+## Usage
+
+```bash
+debugagent run brokenscript.py
+```
+
+That's it. It will:
+1. Run your script and capture the error
+2. Read the source code around the error
+3. Check requirements.txt and git diff
+4. Send everything to an LLM and return a structured diagnosis
+
+## Example
+
+```
+$ debugagent run brokenscript.py
+
+Running: brokenscript.py
+
+Script failed (exit 1)
+
+╭─────────────── Traceback ───────────────╮
+│ Traceback (most recent call last):      │
+│   File "brokenscript.py", line 1        │
+│     import nonexistent_module           │
+│ ModuleNotFoundError: ...                │
+╰─────────────────────────────────────────╯
+
+Analyzing with LLM...
+
+╭─────────────── Root Cause ──────────────╮
+│ The module does not exist               │
+╰─────────────────────────────────────────╯
+╭─────────────── Explanation ─────────────╮
+│ The import statement references a       │
+│ module that is not installed...         │
+╰─────────────────────────────────────────╯
+╭─────────────── Proposed Fix ────────────╮
+│ Install the module or remove the import │
+╰─────────────────────────────────────────╯
+```
+
+## License
+
+MIT

dbgagent-0.1.0/dbgagent.egg-info/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: dbgagent
+Version: 0.1.0
+Summary: AI-powered Python debugger — run a broken script, get root cause, explanation, and fix
+Author: Aryan Tyagi
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aryantyagi2211/Debug_agent
+Project-URL: Issues, https://github.com/aryantyagi2211/Debug_agent/issues
+Keywords: debugger,python,ai,llm,groq
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: groq
+Requires-Dist: python-dotenv
+Requires-Dist: rich
+
+# Debug_agent
+
+AI-powered Python debugger. Run a broken script, get a structured diagnosis with root cause, explanation, and proposed fix.
+
+## Install
+
+```bash
+pip install debugagent
+```
+
+## Setup
+
+Create a `.env` file in your project folder:
+
+```
+GROQ_API_KEY=your_groq_api_key_here
+```
+
+Get a free API key at [console.groq.com](https://console.groq.com).
+
+## Usage
+
+```bash
+debugagent run brokenscript.py
+```
+
+That's it. It will:
+1. Run your script and capture the error
+2. Read the source code around the error
+3. Check requirements.txt and git diff
+4. Send everything to an LLM and return a structured diagnosis
+
+## Example
+
+```
+$ debugagent run brokenscript.py
+
+Running: brokenscript.py
+
+Script failed (exit 1)
+
+╭─────────────── Traceback ───────────────╮
+│ Traceback (most recent call last):      │
+│   File "brokenscript.py", line 1        │
+│     import nonexistent_module           │
+│ ModuleNotFoundError: ...                │
+╰─────────────────────────────────────────╯
+
+Analyzing with LLM...
+
+╭─────────────── Root Cause ──────────────╮
+│ The module does not exist               │
+╰─────────────────────────────────────────╯
+╭─────────────── Explanation ─────────────╮
+│ The import statement references a       │
+│ module that is not installed...         │
+╰─────────────────────────────────────────╯
+╭─────────────── Proposed Fix ────────────╮
+│ Install the module or remove the import │
+╰─────────────────────────────────────────╯
+```
+
+## License
+
+MIT

dbgagent-0.1.0/dbgagent.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+dbgagent.egg-info/PKG-INFO
+dbgagent.egg-info/SOURCES.txt
+dbgagent.egg-info/dependency_links.txt
+dbgagent.egg-info/entry_points.txt
+dbgagent.egg-info/requires.txt
+dbgagent.egg-info/top_level.txt
+debug_agent/__init__.py
+debug_agent/agent.py
+debug_agent/cli.py
+debug_agent/context.py
+debug_agent/runner.py

dbgagent-0.1.0/dbgagent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dbgagent-0.1.0/dbgagent.egg-info/entry_points.txt

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

dbgagent-0.1.0/dbgagent.egg-info/requires.txt

@@ -0,0 +1,3 @@
+groq
+python-dotenv
+rich

dbgagent-0.1.0/dbgagent.egg-info/top_level.txt

@@ -0,0 +1 @@
+debug_agent

dbgagent-0.1.0/debug_agent/agent.py

@@ -0,0 +1,62 @@
+import json
+import os
+from groq import Groq
+
+from .runner import RunResult
+from .context import gather_context
+
+SYSTEM_PROMPT = """\
+You are a Python debugging assistant. Given a traceback, source code context, \
+and project info, produce a JSON object with exactly these fields:
+
+{
+  "root_cause": "concise description of the root cause",
+  "explanation": "detailed explanation of why the error occurs",
+  "proposed_fix": "specific code or steps to fix the issue"
+}
+
+Respond ONLY with valid JSON. No markdown, no extra text.
+"""
+
+
+def _parse_response(raw: str) -> dict:
+    text = raw.strip()
+    if text.startswith("```"):
+        text = text.split("\n", 1)[1]
+        if text.endswith("```"):
+            text = text[: -3].rstrip()
+    return json.loads(text)
+
+
+def analyze(result: RunResult) -> dict:
+    api_key = os.environ.get("GROQ_API_KEY")
+    if not api_key:
+        raise RuntimeError("GROQ_API_KEY not set. Add it to .env or export it.")
+
+    ctx = gather_context(result.error_file or "", result.error_line)
+    prompt = (
+        f"## Traceback\n```\n{result.traceback}\n```\n\n"
+        f"## Error\nType: {result.error_type}\nMessage: {result.error_message}\n\n"
+        f"## Source around error line\n```\n{ctx['source_snippet']}\n```\n\n"
+        f"## Project context\n{ctx['requirements']}\n\n"
+        f"## Recent changes\n{ctx['git_diff']}\n"
+    )
+
+    client = Groq(api_key=api_key)
+    last_error = None
+    for _ in range(2):
+        try:
+            resp = client.chat.completions.create(
+                model="llama-3.3-70b-versatile",
+                messages=[
+                    {"role": "system", "content": SYSTEM_PROMPT},
+                    {"role": "user", "content": prompt},
+                ],
+                temperature=0.1,
+                max_tokens=1024,
+            )
+            return _parse_response(resp.choices[0].message.content)
+        except Exception as e:
+            last_error = e
+
+    raise RuntimeError(f"Failed to parse LLM response after 2 attempts.\nLast error: {last_error}")

dbgagent-0.1.0/debug_agent/cli.py

@@ -0,0 +1,55 @@
+import argparse
+import sys
+
+from dotenv import load_dotenv
+from rich.console import Console
+from rich.panel import Panel
+
+from .runner import run_script
+from .agent import analyze
+
+
+def main():
+    load_dotenv()
+    console = Console()
+
+    parser = argparse.ArgumentParser(prog="debugagent", description="Run a Python script, capture errors, and get AI-powered debugging help.")
+    sub = parser.add_subparsers(dest="command")
+    run_parser = sub.add_parser("run", help="Run and debug a Python script")
+    run_parser.add_argument("script", help="Path to the Python script to debug")
+
+    args = parser.parse_args()
+    if args.command != "run":
+        parser.print_help()
+        sys.exit(1)
+
+    console.print(f"[bold cyan]Running:[/] {args.script}\n")
+
+    try:
+        result = run_script(args.script)
+    except (FileNotFoundError, PermissionError, ValueError) as e:
+        console.print(f"[bold red]Error:[/] {e}")
+        sys.exit(1)
+
+    if result.returncode == 0:
+        console.print("[bold green]Script ran successfully.[/] No errors to debug.")
+        if result.stdout:
+            console.print(f"\n[dim]stdout:[/]\n{result.stdout}")
+        sys.exit(0)
+
+    console.print(f"[bold red]Script failed (exit {result.returncode})[/]\n")
+    console.print(Panel(result.traceback, title="Traceback", border_style="red"))
+
+    console.print("[bold yellow]Analyzing with LLM...[/]\n")
+    try:
+        analysis = analyze(result)
+    except RuntimeError as e:
+        console.print(f"[bold red]Agent error:[/] {e}")
+        sys.exit(1)
+
+    for key, title, color in [("root_cause", "Root Cause", "red"), ("explanation", "Explanation", "yellow"), ("proposed_fix", "Proposed Fix", "green")]:
+        console.print(Panel(analysis[key], title=title, border_style=color))
+
+
+if __name__ == "__main__":
+    main()

dbgagent-0.1.0/debug_agent/context.py

@@ -0,0 +1,40 @@
+import subprocess
+from pathlib import Path
+
+
+def read_file_around_error(file_path: str, line_number: int, radius: int = 15) -> str:
+    path = Path(file_path)
+    if not path.exists():
+        return f"[File not found: {file_path}]"
+    try:
+        lines = path.read_text(encoding="utf-8", errors="replace").splitlines()
+    except Exception as e:
+        return f"[Error reading file: {e}]"
+
+    start, end = max(0, line_number - radius - 1), min(len(lines), line_number + radius)
+    return "\n".join(
+        ("%s %4d | %s" % (">>>" if i == line_number - 1 else "   ", i + 1, lines[i]))
+        for i in range(start, end)
+    )
+
+
+def gather_context(error_file: str, error_line: int | None) -> dict:
+    source = read_file_around_error(error_file, error_line) if error_line else "No error line."
+
+    req_path = Path(error_file).parent / "requirements.txt"
+    requirements = f"requirements.txt:\n{req_path.read_text('utf-8', errors='replace')}" if req_path.exists() else "No requirements.txt."
+
+    try:
+        diff = subprocess.run(
+            ["git", "diff", "HEAD"], capture_output=True, text=True, encoding="utf-8", errors="replace", timeout=10,
+        )
+        git_diff = f"git diff HEAD:\n{diff.stdout}" if diff.returncode == 0 and diff.stdout.strip() else "No uncommitted changes."
+    except (FileNotFoundError, Exception):
+        git_diff = "Git not available."
+
+    # ponytail: hard truncation keeps prompt under Groq free-tier 12k TPM limit
+    return {
+        "source_snippet": source[:2000],
+        "requirements": requirements[:1000],
+        "git_diff": git_diff[:2000],
+    }

dbgagent-0.1.0/debug_agent/runner.py

@@ -0,0 +1,69 @@
+import re
+import subprocess
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass
+class RunResult:
+    stdout: str
+    stderr: str
+    traceback: str
+    returncode: int
+    error_type: str | None
+    error_message: str | None
+    error_line: int | None
+    error_file: str | None
+
+
+def run_script(script_path: str) -> RunResult:
+    path = Path(script_path)
+
+    if not path.exists():
+        raise FileNotFoundError(f"Script not found: {script_path}")
+    if path.suffix != ".py":
+        raise ValueError(f"Not a Python file: {script_path}")
+
+    try:
+        proc = subprocess.run(
+            [sys.executable, str(path.resolve())],
+            capture_output=True,
+            text=True,
+            encoding="utf-8",
+            errors="replace",
+            timeout=30,
+        )
+    except PermissionError as e:
+        raise PermissionError(f"Permission denied executing {script_path}: {e}")
+
+    tb_lines = proc.stderr.strip().splitlines() if proc.returncode != 0 else []
+    error_type = error_message = error_file = error_line = None
+
+    for i, line in enumerate(tb_lines):
+        if line.startswith("  File ") and "line " in line:
+            m = re.search(r'File "(.+?)", line (\d+)', line)
+            if m:
+                error_file, error_line = m.group(1), int(m.group(2))
+            # skip indented lines and nested File entries to reach error message
+            for tail in tb_lines[i + 1 :]:
+                if tail.startswith("  File ") and "line " in tail:
+                    continue
+                if tail.startswith("    "):
+                    continue
+                if ":" in tail:
+                    error_type, error_message = tail.split(":", 1)
+                    error_type, error_message = error_type.strip(), error_message.strip()
+                break
+            break
+
+    return RunResult(
+        stdout=proc.stdout,
+        stderr=proc.stderr,
+        traceback="\n".join(tb_lines),
+        returncode=proc.returncode,
+        error_type=error_type,
+        error_message=error_message,
+        error_line=error_line,
+        error_file=error_file,
+    )

dbgagent-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dbgagent"
+version = "0.1.0"
+description = "AI-powered Python debugger — run a broken script, get root cause, explanation, and fix"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Aryan Tyagi" }]
+keywords = ["debugger", "python", "ai", "llm", "groq"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "groq",
+    "python-dotenv",
+    "rich",
+]
+
+[project.urls]
+Homepage = "https://github.com/aryantyagi2211/Debug_agent"
+Issues = "https://github.com/aryantyagi2211/Debug_agent/issues"
+
+[tool.setuptools.packages.find]
+include = ["debug_agent*"]
+
+[project.scripts]
+debugagent = "debug_agent.cli:main"

dbgagent-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+