# SelfHeal

> SelfHeal is a self-healing API proxy for AI agents. It intercepts failed API calls, analyzes errors with an LLM, and returns structured fix instructions your agents can act on — so they retry autonomously instead of crashing.

## Product

- [Homepage](https://selfheal.dev/): Self-healing API proxy — drop-in integration for any AI agent stack
- [Docs](https://selfheal.dev/docs): Full API documentation, SDK guides, integration examples
- [Dashboard](https://selfheal.dev/dashboard): Monitor requests, track errors, manage API keys
- [Status](https://selfheal.dev/status): Live uptime and latency metrics
- [Changelog](https://selfheal.dev/changelog): Release notes and feature updates

## How It Works

1. Your agent sends API calls through the SelfHeal proxy (set X-Destination-URL header to the real API)
2. Successful responses (2xx/3xx) pass through with zero overhead — no credits consumed
3. Failed responses (4xx/5xx) are intercepted, analyzed by an LLM, and returned with structured JSON fix instructions
4. Your agent reads the fix (is_retriable, error_category, suggested_payload_diff) and self-corrects

## Key Features

- Instant Error Intelligence — LLM analyzes exact payload and returns actionable fix, not generic error messages
- Security-First — Authorization, Cookie, and API key headers stripped before LLM analysis
- Zero-Overhead Pass-Through — Successful requests forwarded transparently with no latency
- Agent-Native JSON Schema — Structured envelope with is_retriable, actionable_fix_for_agent, suggested_payload_diff
- Full Observability — Dashboard with request logs, error rates, credit usage

## SDKs

- Python: `pip install graceful-fail` ([PyPI](https://pypi.org/project/graceful-fail/)) — sync, async, LangChain, CrewAI
- Node.js/TypeScript: `npm install graceful-fail` ([npm](https://www.npmjs.com/package/graceful-fail)) — ESM and CJS

## Pricing

- Hobby (Free): 500 requests/month, LLM error analysis, API key management
- Pro ($29/month): 10,000 requests/month, multiple API keys, usage analytics
- Agency ($99/month): 50,000 requests/month, unlimited API keys, priority support

## Contact

- Website: https://selfheal.dev
- Built by [Freedom Engineers](https://freedomengineers.tech)