SciTeX Notification

One-call alerting across 9 backends — audio, desktop, emacs, matplotlib, playwright, email, webhook, Telegram, Twilio.

SciTeX Notification provides a unified alerting interface across 9 backends with automatic fallback. Perfect for long-running scientific computations, AI agents, and any workflow that needs your attention — even while you sleep.

Backends

Backend	Transport	Cost	Internet	Notes
Audio	TTS to local speakers	Free	No	Via scitex-audio; SSH relay supported
Desktop	notify-send / PowerShell	Free	No	Linux / WSL
Emacs	emacsclient popup	Free	No	Popup, minibuffer, or alert
Matplotlib	Visual popup window	Free	No	Requires matplotlib
Playwright	Browser popup	Free	No	Requires playwright
Email	SMTP	Free	Required	Gmail, SMTP relay
Webhook	HTTP POST	Free	Required	Slack, Discord, custom endpoints
Telegram	Telegram Bot API	Free	Required	No SDK dependency (urllib only)
Twilio	Phone call / SMS	Paid	Required	Twilio account needed; no SDK dependency

User Guide

• Quickstart
  • Installation
  • Basic Usage
  • Async Usage
• Backends
  • Available Backends
  • Fallback Priority
• Configuration
  • Default Backend
  • Per-Backend Configuration
  • Programmatic Use
• Environment Variables
  • General
  • Email
  • Twilio
  • Telegram
  • Webhook
  • Playwright

API Reference

• scitex_notification
  • alert()
  • alert_async()
  • available_backends()
  • call()
  • call_async()
  • notify()
  • send_gmail()
  • sms()
  • sms_async()
• Backends API
  • AudioBackend
  • BaseNotifyBackend
  • DesktopBackend
  • EmacsBackend
  • EmailBackend
  • MatplotlibBackend
  • NotifyLevel
  • NotifyResult
  • PlaywrightBackend
  • TelegramBackend
  • TwilioBackend
  • WebhookBackend
  • available_backends()
  • get_backend()
• MCP Server
  • NotifyServer
  • main()
  • available_backends_handler()
  • get_config_handler()
  • get_tool_schemas()
  • list_backends_handler()
  • notify_handler()

Quick Examples

import scitex_notification as stxn

# Simple alert — fallback: audio → emacs → matplotlib → playwright → email
stxn.alert("Training complete. Val loss: 0.042")

# Specific backend
stxn.alert("Job finished", backend="email")

# Escalate to phone call
stxn.call("Server is down — wake up!")

# Send SMS
stxn.sms("Build done!")

Indices and tables

• Index

• Module Index

• Search Page