🛡️ HealSpace

Automated AI runtime guardian for Hugging Face Spaces.

HealSpace monitors your Space for runtime errors, attempts automatic fixes, and alerts you — so your Space stays alive even when you're not watching.

Install

pip install healspace

Quickstart

import healspace as HS

HS.protect(demo)
demo.launch()

Or the one-liner shorthand:

import healspace as HS
HS(demo)
demo.launch()

Configuration

Call HS.configure() before HS.protect() to customise behaviour. All commands support inline # comments and are case-insensitive.

import healspace as HS

HS.configure(
    "disable HS_promo\n"
    "inspect every 30 sec\n"
    "set fix quota to 100\n"
    "inform dev when retry count 10\n"
    'set inform email to "you@gmail.com"\n'
    "retry limit 50\n"
)

HS.protect(demo)
demo.launch()

Command Reference

disable HS_promo

Removes the Protected by HealSpace footer from your Gradio UI. Enabled by default — use this if it conflicts with your layout.

disable HS_promo

inspect every N sec / min / hrs

Starts a background polling loop that actively checks for errors on a schedule.

Without this, HealSpace only reacts when an error surfaces on stderr. With this, it proactively scans at every interval.

inspect every 30 sec
inspect every 5 min
inspect every 1 hrs

set fix quota to N

Caps the number of automatic fixes HealSpace will apply this session. After the quota is reached HealSpace continues to detect and report errors, but stops applying fixes.

set fix quota to 100

Without this, HealSpace fixes indefinitely.

inform dev when retry count N

Sends a Hugging Face inbox notification to your account once the total number of errors in this session reaches N.

inform dev when retry count 10

Requires HF_TOKEN to be set as a Space secret (Settings → Variables and secrets).

set inform email to "address"

Sends an email alert to any address when errors accumulate.

set inform email to "you@gmail.com"
set inform email to "team@company.io"

Works with any email provider — Gmail, Outlook, Yahoo, iCloud, custom domains. Emails arrive from healspace@proton.me.

Requires one Space secret — no password, no SMTP config:

retry limit N

Hard stop. After N total errors HealSpace prints a final warning, sends one last email + HF inbox message (if configured), then raises a RuntimeError that stops the Space process entirely.

retry limit 50

Use this when you want a broken Space to fail loudly and visibly rather than silently loop forever.

What HealSpace Fixes Automatically

Space Secrets Reference

Add secrets under Space Settings → Variables and secrets.

Mini AI — Code Healer

HealSpace also ships a context-aware code repair engine that reads your codebase style (indentation, quotes, naming, type hints) and writes fixes that match it.

from healspace import CodeHealer

healer = CodeHealer()
patch  = healer.heal_traceback(traceback_text, source_file="app.py")
print(patch)   # shows a diff
patch.apply()  # writes the fix back to the file

Full API

import healspace as HS

HS.fix_quota = 10        # set quota via attribute
HS.protect(demo)         # inject UI + start monitoring
HS.watch()               # start background stderr monitor only
HS.heal(demo)            # one-call: monitor + protect
HS.configure("...")      # apply DSL config string
HS.fix(report)           # manually attempt a fix for an ErrorReport

License

Apache 2.0 — pypi.org/project/healspace