Documentation

Everything you need to get Grumpy yelling at your codebase in under 5 minutes.

Quick Start

Python Setup

Step 1: Install the SDK

pip install desicon-grumpy

Step 2: Initialize Grumpy

from grumpy_ai import grumpy

grumpy.init(
    api_key="grp_live_xxxx",   # From your dashboard
    app_name="My App",
    environment="production",  # "production" | "staging" | "development"
    rescue_engine=True,        # Automatically apply AI hotfixes
    level="error"              # "fatal" | "error" | "warning"
)

Node.js Setup

Step 1: Install the SDK

npm install desicon-grumpy

Step 2: Initialize Grumpy

const { grumpy } = require('desicon-grumpy');

grumpy.init({
    apiKey: "grp_live_xxxx",   // From your dashboard
    appName: "My App",
    environment: "production", // "production" | "staging" | "development"
    rescueEngine: true,        // Automatically apply AI hotfixes
    level: "error"             // "fatal" | "error" | "warning"
});

Browser CDN Setup

Step 1: Install the SDK

<!-- Drop this in your <head> -->
<script src="https://cdn.jsdelivr.net/gh/Desicon-AI/grumpy-cdn@main/grumpy.js"></script>

Step 2: Initialize Grumpy

<script>
  Grumpy.init({
    apiKey: "grp_live_xxxx",   // From your dashboard
    appName: "My Frontend App",
    environment: "production", // "production" | "staging" | "development"
    rescueEngine: true,        // Automatically apply AI hotfixes
    level: "error"             // "fatal" | "error" | "warning"
  });
</script>

Step 3: Break something

Seriously. Throw an exception. Grumpy will intercept it, analyze it with AI, and send you a beautifully roasted alert in your Slack or Discord channel within seconds.

Configuration

Python Parameter	Node.js / Browser Parameter	Type	Description
api_key	apiKey	string	Your project API key from the dashboard.
app_name	appName	string	A human-readable name for your application.
environment	environment	string	Current deployment environment: 'production', 'staging', or 'development'.
rescue_engine	rescueEngine	boolean	Set to true to enable automated AI hotfix generation and patching.
level	level	string	fatal \| error \| warning

The Sensitivity Dialer

The Sensitivity Dialer controls how much noise Grumpy generates. Set it in two places:

SDK: Set level in grumpy.init().
Dashboard: Override per-project in Settings. Server enforces it.

Low

fatal

Only unhandled crashes.

grumpy.init({ level: "fatal" });

Medium

error

Caught exceptions + fatal.

grumpy.init({ level: "error" });

High

warning

Everything. Good luck.

grumpy.init({ level: "warning" });

Grumpy Rescue Engine

A Premium feature that allows Grumpy to dynamically patch bugs in real-time.

When the Rescue Engine is enabled (via Project Settings), Grumpy doesn't just send you an alert. It instructs your connected AI to generate a functional, sandboxed JavaScript hotfix that fixes the logical error.

This patch is saved to the Grumpy backend. The next time any user loads your client application, the Grumpy SDK automatically fetches all active patches and applies them in memory before your code runs. This means you can hotfix logic errors across the globe with zero downtime, no redeployments, and complete sandboxed safety.

How to use it

• 1. Enable 'Grumpy Rescue Engine' in your Project settings.
• 2. Ensure you have an AI Provider configured in settings.
• 3. When an unhandled error occurs, Grumpy will generate a `<RESCUE_PATCH>`.
• 4. The SDK downloads and applies this patch on the next client load, silently fixing the bug for everyone else.

Stack Compatibility & Frameworks

The Rescue Engine dynamically patches JavaScript bugs in the browser, but it is fully compatible with ANY backend stack.

Server-Rendered Apps

Even if your backend is Python or PHP, your users still interact with HTML/JS in the browser. Drop the Grumpy JS SDK into your Jinja2, Django, or Blade templates. The Rescue Engine will catch and hotfix frontend JavaScript bugs seamlessly.

base.html (Jinja2 / Django / Blade)

<!DOCTYPE html>
<html>
<head>
    <!-- Drop Grumpy before your other scripts -->
    <script src="https://cdn.jsdelivr.net/gh/Desicon-AI/grumpy-cdn@main/grumpy.js"></script>
    <script>
      Grumpy.init({
        apiKey: "{{ GRUMPY_API_KEY }}", // Passed from backend
        appName: "My Web App",
        rescueEngine: true
      });
    </script>
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

AI Personas

Grumpy speaks in three voices. Choose the one that fits your team culture. Personas are set at the Organization level and apply to all projects.

Grumpy

All Plans

Sarcastic & Mean

The default. Grumpy roasts your code, insults your variable names, and grudgingly tells you how to fix it. Perfect for teams with thick skin and a sense of humor.

"You passed a string to parseInt and expected magic? Cast your variables, you absolute menace. Here's the fix, don't make me say it twice."

Friendly

Pro / Team

Supportive & Positive

A warm, encouraging senior dev who wants you to know it's going to be okay. Uses emojis. Celebrates small wins. Great for junior-heavy teams or if HR keeps filing complaints.

"Hey! 👋 Looks like a small type mismatch slipped through — happens to everyone! Here's a quick fix. You're doing great! 🎉"

Professional

Pro / Team

Strategic & Objective

An enterprise-grade SRE delivering strictly factual root cause analysis and remediation steps. No jokes, no fluff. Designed for large organizations, regulated industries, and teams that need clean audit trails.

"Root Cause: Type coercion failure in paymentAPI.submit(). Remediation: Validate input type before invocation. Patch recommended."

How to configure

All future error analyses across every project in your organization will use the new voice.

1. Dashboard → Settings → Organization Persona
2. Select your preferred persona and click Save

Integrations

Bring Your Own AI (BYOAI)

Grumpy works out of the box for free using our massive database of hand-crafted roasts. But if you want AI to suggest actual code fixes, connect any AI provider (OpenAI, Anthropic, Groq, Ollama). We never markup token usage. If your API goes down, Grumpy seamlessly falls back to standard mode.

Dashboard → Settings → Select Provider → Paste Key

Slack Webhooks

Grumpy sends rich, formatted alerts directly to your Slack channels with full stack traces, AI analysis, and severity badges.

1. Dashboard → Settings → Connect Slack
2. Slack → Channel → Settings → Integrations → Add Grumpy

Discord Webhooks

Same rich alerts, same brutal honesty — delivered to your Discord server. Perfect for indie devs and open source projects.

Dashboard → Settings → Connect Discord (automatic)

The 'Not My Fault' Engine

Our 'Not My Fault' engine analyzes stack traces.

If a crash originated from an external package, we will notify the maintainer of the issue so they can work on it.

But we are smart about it. If we notice that the error was caused by missing parameters or incorrect usage by the developer, rather than sending the maintainer a ticket, we notify the developer of the correct use.

For Maintainers

Sign up for a free Grumpy account to claim and track your public npm/pip packages. You only need a paid subscription if you want to use Grumpy to monitor your own applications.

For Developers

Enable this feature within your project settings so that genuine errors from external packages are automatically sent to the maintainers.

Dashboard → Settings → Enable 'Not My Fault'