ravn-sdk 0.2.0

Error monitoring for Python without the Sentry tax — 100k events free, AI root cause analysis included

ravn-sdk

Error monitoring for Python — without the Sentry tax.
100,000 events/month free. AI-powered root cause analysis included. Setup in 30 seconds.

→ getravn.com · Dashboard · Docs

---

Install

pip install ravn-sdk

Setup

import ravn

ravn.init(api_key="your_api_key_here")

That's it. Every unhandled exception that crashes the process — scripts, Celery tasks, background workers — is now captured automatically.

Using Django, Flask, or FastAPI? These frameworks catch request-handling exceptions themselves to render an error response, so they never reach the point ravn.init() hooks into. Add one line for your framework:

# Django — in AppConfig.ready() or wsgi.py/asgi.py
from ravn.integrations.django import install
install()

# Flask
from ravn.integrations.flask import init_app
init_app(app)

# FastAPI / Starlette
from ravn.integrations.fastapi import RavnMiddleware
app.add_middleware(RavnMiddleware)

Get your API key at app.getravn.com/register — free, no credit card required.

---

Features

Automatic exception capture

After ravn.init(), all unhandled exceptions are captured automatically.

Manual capture

try:
    risky_operation()
except Exception as e:
    ravn.capture_exception(e, metadata={"user_id": 42})

Log messages

ravn.capture_message("Payment processed", level="info", metadata={"amount": 99.99})

Supported levels: info, warning, error.

Performance monitoring

@ravn.measure
def slow_database_query():
    ...

Functions decorated with @ravn.measure send a warning event if they exceed slow_threshold_ms (default: 1000ms).

---

Configuration

ravn.init(
    api_key="your_api_key_here",
    slow_threshold_ms=500,  # warn if functions take longer than 500ms
)

---

Pricing

Plan	Events/month	Price
Free	100,000	$0 — forever
Solo	1,000,000	$9.99/mo
Team	10,000,000	$19.99/mo
Business	100,000,000	$49.99/mo

All paid plans include AI root cause analysis, Slack/Discord alerts, and performance monitoring.
Full pricing at getravn.com/pricing.

---

Requirements

• Python ≥ 3.8
• requests ≥ 2.28

License

MIT