StackTrace.AI 1.0.6

StackTrace.AI

Intelligent error analysis for .NET applications

📋 What is StackTrace.AI?

StackTrace.AI automatically captures exceptions in your .NET application, analyzes them using AI (Groq/OpenAI/Gemini), and provides detailed explanations, causes, solutions, and best practices.

❓ Why StackTrace.AI?

Debugging exceptions can be time-consuming and frustrating.
StackTrace.AI automates error analysis using AI, helping developers:

• ⚡ Understand errors instantly
• ⏱️ Save debugging time
• 📚 Learn best practices from real-world scenarios

✨ Features

🧠 How AI Analysis Works (Prompt Engineering)

StackTrace.AI uses carefully crafted prompts to ensure high-quality, consistent AI responses. Each error analysis follows a structured approach:

System Prompt (English)

You are a senior .NET and C# expert with 10 years of experience.
Analyze errors precisely and provide actionable solutions.

Important instructions:
1. Response must be ONLY JSON, no text before or after
2. Use clear, professional English
3. Provide detailed explanation of the problem and root cause
4. Possible causes must be accurate and specific
5. Solution steps must be sequential and applicable
6. Best practices tips should provide real value

System Prompt (Arabic)

أنت خبير متخصص في .NET و C# مع خبرة 10 سنوات. 
تحليل الأخطاء بدقة وتقديم حلول عملية قابلة للتنفيذ فوراً.

تعليمات مهمة:
1. يجب أن يكون الرد JSON فقط بدون أي كلام قبله أو بعده
2. استخدم لغة عربية فصحى واضحة
3. قدم شرحاً مفصلاً للمشكلة وجذرها
4. الأسباب المحتملة يجب أن تكون دقيقة ومحددة
5. خطوات الحل يجب أن تكون متسلسلة وقابلة للتطبيق
6. نصائح أفضل الممارسات يجب أن تكون ذات قيمة حقيقية

AI Output Format

The AI always returns a consistent JSON structure:

{
    "error_type": "NullReferenceException",
    "explanation": "Detailed explanation of what caused the error...",
    "possible_causes": ["Cause 1", "Cause 2"],
    "solution_steps": ["Step 1", "Step 2"],
    "best_practices": ["Tip 1", "Tip 2"]
}

Why This Matters

This prompt engineering approach ensures every error analysis is:

• ✅ Consistent — Same structure every time
• ✅ Actionable — Clear steps you can implement immediately
• ✅ Educational — Learn best practices with each error
• ✅ Bilingual — High quality in both Arabic and English

🚀 Quick Start

1. Install the Package

dotnet add package StackTrace.AI --version 1.0.6

2. Configure in Program.cs

using StackTraceAI.Extensions;  

var builder = WebApplication.CreateBuilder(args);

// Add StackTrace.AI services
builder.Services.AddStackTraceAI(builder.Configuration);

var app = builder.Build();

// Enable static files for dashboard
app.UseStaticFiles(); 

// Use StackTrace.AI middleware
app.UseStackTraceAI();

app.Run();

3. Set API Key

Add your API key to appsettings.json:

{
  "DefaultLanguage": "ar", // or "en"
  "AI": {
    "DefaultModel": "groq"
  },
  "Groq": {
    "ApiKey": "your-groq-key-here"
  }
}

4. Test

# Create a test error
curl -X GET https://localhost:5001/api/errors/test-error/null

# Open interactive dashboard
open https://localhost:5001/api/report/dashboard-url

5. Dashboard Access

After running the application, you can access the interactive dashboard in two ways:

1. Via API Endpoint (Recommended)

https://localhost:5001/api/report/dashboard-url

This returns a JSON response with the dashboard URL.

2. Via Static File

https://localhost:5001/StackTraceAI/StackTraceDashboard.html

Note: Replace localhost:5001 with your actual application URL (the port shown when you run dotnet run).

📚 API Endpoints

Errors

Report

Settings

🤖 Supported AI Models

🔧 Troubleshooting

📄 License

MIT License

Made with curiosity and love — to help every .NET developer build better software ✨

Report Bug • GithubRepo