Python SDK

Django, Flask, FastAPI, or a plain worker. Standard library only.For any Python service. No dependencies — it vendors cleanly if you prefer.

Install

terminal — bash
pip install vigil-sdk

Initialize

app.py — python
import vigil
vigil.init(key="vg_pub_YOUR_KEY", endpoint="https://vigill.dev/api/ingest")
# Uncaught exceptions are captured automatically (via sys.excepthook).
try:
    charge_card(order)
except Exception:
    vigil.capture_exception()
    raise

What it captures automatically

These arrive with zero extra code — the unhandled failures that would otherwise crash or vanish.

Uncaught exceptions, via sys.excepthook — the ones that would end the process.
Uncaught exceptions on threads (threading.excepthook) where available.

When to capture manually

A web framework catches exceptions to return a 500 page rather than crashing the worker, so sys.excepthook never fires. Call vigil.capture_exception() inside your except block to report the handled error.

a view / route — python
@app.post("/checkout")
def checkout():
    try:
        charge_card(request.json)
        return {"ok": True}
    except Exception:
        vigil.capture_exception(tags={"route": "checkout"})
        return {"error": "Payment failed"}, 500

Configuration

Set environment and release so a bad deploy groups separately from the last one.

app.py — python
vigil.init(
    key="vg_pub_YOUR_KEY",
    endpoint="https://vigill.dev/api/ingest",
    environment="production",
    release=os.environ.get("GIT_SHA"),
    tags={"service": "api"},
)

What you get

init(key, endpoint=..., environment=..., release=..., tags=...)
capture_exception(exc=None, tags=None) — call inside an except block
capture_message(message, level="info", tags=None) · flush() / close()

app.py — python

import vigil vigil.init(key="vg_pub_YOUR_KEY", endpoint="https://vigill.dev/api/ingest") # Uncaught exceptions are captured automatically (via sys.excepthook). try: charge_card(order) except Exception: vigil.capture_exception() raise

When to capture manually

a view / route — python

@app.post("/checkout") def checkout(): try: charge_card(request.json) return {"ok": True} except Exception: vigil.capture_exception(tags={"route": "checkout"}) return {"error": "Payment failed"}, 500