All Toolsโ€บDebug Sentinel
๐Ÿ’ป AI Coding AssistantsApril 11, 2026โœ… Tests passing

Debug Sentinel

Debug Sentinel is a Python library that integrates with AI coding assistants to analyze runtime errors and suggest fixes in real-time. By analyzing stack traces, it provides concise explanations and suggests code modifications to resolve issues efficiently.

What It Does

  • Analyze Python stack traces.
  • Get suggestions for fixing runtime errors.
  • Output results in either plain text or JSON format.

Installation

1. Install the required Python packages:

pip install openai pytest

2. Save the debug_sentinel.py file to your desired location.

Usage

Run the tool from the command line:

python debug_sentinel.py <path_to_stack_trace_file> --api-key <your_openai_api_key> [--output-format text|json]

Arguments

  • input: Path to the file containing the Python stack trace.
  • --api-key: Your OpenAI API key (required).
  • --output-format: Output format for suggestions. Options are text (default) or json.

Example

python debug_sentinel.py stack_trace.txt --api-key sk-abc123 --output-format json

Source Code

import traceback
import json
import argparse
from openai import ChatCompletion

class DebugSentinel:
    def __init__(self, api_key):
        self.api_key = api_key

    def suggest_fix(self, stack_trace, output_format="text"):
        """
        Analyze the provided stack trace and return suggested fixes.

        Args:
            stack_trace (str): The Python exception stack trace.
            output_format (str): Output format, either 'text' or 'json'.

        Returns:
            str: Suggested fixes in the specified format.
        """
        if not stack_trace.strip():
            raise ValueError("Stack trace cannot be empty.")

        try:
            response = ChatCompletion.create(
                model="gpt-4",
                messages=[
                    {"role": "system", "content": "You are an AI assistant that helps debug Python errors."},
                    {"role": "user", "content": f"Analyze this stack trace and suggest fixes:\n{stack_trace}"}
                ]
            )

            suggestions = response["choices"][0]["message"]["content"].strip()

            if output_format == "json":
                return json.dumps({"suggestions": suggestions}, indent=4)
            return suggestions

        except Exception as e:
            return f"Error occurred while processing: {str(e)}"


def main():
    parser = argparse.ArgumentParser(description="Debug Sentinel: Analyze Python stack traces and suggest fixes.")
    parser.add_argument("input", help="Path to the file containing the Python stack trace.")
    parser.add_argument("--output-format", choices=["text", "json"], default="text", help="Output format: 'text' or 'json'.")
    parser.add_argument("--api-key", required=True, help="OpenAI API key.")

    args = parser.parse_args()

    try:
        with open(args.input, "r") as file:
            stack_trace = file.read()

        sentinel = DebugSentinel(api_key=args.api_key)
        suggestions = sentinel.suggest_fix(stack_trace, output_format=args.output_format)
        print(suggestions)

    except FileNotFoundError:
        print(f"Error: File '{args.input}' not found.")
    except ValueError as ve:
        print(f"Error: {ve}")
    except Exception as e:
        print(f"An unexpected error occurred: {e}")

if __name__ == "__main__":
    main()

Community

Downloads

ยทยทยท

Rate this tool

No ratings yet โ€” be the first!

Details

Tool Name
debug_sentinel
Category
AI Coding Assistants
Generated
April 11, 2026
Tests
Passing โœ…
Fix Loops
2

Quick Install

Clone just this tool:

git clone --depth 1 --filter=blob:none --sparse \
  https://github.com/ptulin/autoaiforge.git
cd autoaiforge
git sparse-checkout set generated_tools/2026-04-11/debug_sentinel
cd generated_tools/2026-04-11/debug_sentinel
pip install -r requirements.txt 2>/dev/null || true
python debug_sentinel.py
Debug Sentinel โ€” AI Tools by AutoAIForge