🚀 Telert – Your Ultimate Code Command Center

Telert is your productivity command center for Python development and terminal operations.
It monitors your code and commands in real time, tracks execution duration, and delivers smart notifications when they complete — so you can stay focused on other work instead of constantly checking back.

💡 Perfect for developers, data scientists, DevOps engineers, or anyone who needs to monitor long-running code and stay productive.

✅ Smart Python Integration: Wrap any Python code block or function with telert context managers or decorators in one click, auto-tracking execution time and success status.

✅ Multi-channel notifications: Get alerts via desktop pop-ups, mobile apps, messaging tools like Telegram, Slack, Discord, Microsoft Teams, or even custom HTTP webhooks.

⚡ Quick Start

1. Configure Your Notification Provider

   • Click the Telert bell icon in the status bar → Configure Notification Provider

   • Choose from Telegram, Slack, Teams, Discord, Pushover, or Desktop

   • Enter your credentials (tokens or webhooks)

     

   📘 Setup Docs:

   • Telegram · Slack · Teams · Discord · Pushover

2. Run a Command with Notifications

   • Click the bell icon or right-click a file → Run in Integrated Terminal and Notify

   • Or open Command Palette → Telert: Run in Integrated Terminal and Notify

   • A timer starts in the status bar, and you’ll be notified when the command finishes

     

3. (Optional) Install CLI manually (auto-installed by extension):

   pip install --upgrade telert
   

🔥 Why Use Telert?

• 🔄 Monitor Your Code: Wrap Python functions with @notify or blocks with telert() context managers
• ⏳ Track Execution Time: Automatically measures how long your code or commands take
• 💥 Exception Handling: Get notified immediately when code crashes with detailed error info
• 📳 Smart Alerting: Choose between "always notify" or "only on failure" for different scenarios
• 📱 Cross-Device Support: Get alerts on desktop, mobile, chat platforms, or custom APIs
• 💻 Seamless VS Code Integration: Just right-click to add monitoring to any Python code
• 💼 Ideal for Remote Work: Perfect for long-running tasks when you're away from your desk
• 🔧 Highly Customizable: Set thresholds, customize providers, configure notification content

📡 Supported Notification Channels

✨ Key Features

🔧 Installation & Setup

1. Install CLI (optional)

pip install --upgrade telert

2. Configure Notification Provider

Option A: CLI

telert config telegram --token "<your-token>" --chat-id "<your-chat-id>" --set-default

Option B: VS Code Settings

"telert.defaultProvider": "telegram",
"telert.environmentVariables": {
  "TELERT_TELEGRAM_TOKEN": "<your-token>",
  "TELERT_TELEGRAM_CHAT_ID": "<your-chat-id>"
}

💡 Replace variables with those for Slack, Pushover, Teams, or Discord (e.g. TELERT_SLACK_WEBHOOK, TELERT_PUSHOVER_TOKEN, etc.).

3. Verify

telert status

🧪 Usage Examples

🧬 Data Science & ML

python train_model.py --epochs 100

🛠️ DevOps / Infra

terraform apply -auto-approve

🌐 Web Dev

npm run build

⚙️ Configuration Options

🧩 How to Use in VS Code

🔹 Add Telert to Python Code

1. Select a Python function or code block (or just place cursor in function)
2. Right-click → Telert: Wrap with notify decorator or Telert: Wrap with telert context manager
3. Choose notification options and provider
4. Get notified when your code completes or fails!

Example decorator:

from telert import notify

@notify("process_data", only_fail=True)
def process_data(filename):
    # Your function code here
    return result

Example context manager:

from telert import telert

with telert("Data processing"):
    # Your code block here
    process_large_dataset()

🔹 Run Code with Notifications

1. Right-click file → Telert: Run in Integrated Terminal and Notify
2. OR: Use Command Palette
3. OR: Click Telert bell icon in status bar

🔹 Monitor Python Processes

1. Right-click in a Python file → Telert: Monitor Python Process
2. OR: Use Command Palette → Telert: Monitor Python Process
3. Select from running Python processes or enter a PID manually
4. Get notified when the process completes, with exact execution time

🔹 Configure with Quick Pick

1. Open Command Palette → Telert: Configure Notification Provider
2. Follow guided steps for setup

🔗 Resources

• 📦 Telert GitHub
• 📚 Telert CLI Docs
• 📄 Full Provider Setup Guides
• 🚀 Telert on PyPI

🌟 Use Cases

📊 Data Scientists

• Add Telert to model training scripts to get notified when training completes or fails
• Wrap data preprocessing functions to track execution time and errors
• Monitor batch processing of large datasets with automatic alerting

🧪 DevOps & SRE

• Get instant notifications when pipelines complete or fail
• Monitor long-running infrastructure operations
• Track the status of scheduled tasks and deployments

📱 Backend/API Developers

• Monitor API endpoints during development
• Get alerted when API tests complete
• Track long-running database operations

🔬 Research & Academic Computing

• Monitor simulations that run for hours or days
• Get notified when complex calculations complete
• Track experimental runs with success/failure notifications

💎 Why Developers Love Telert

"Telert completely changed how I handle my ML training workflows. Now I can work on other tasks while my models train, knowing I'll get notified instantly when they're done." — Data Scientist

"As a remote developer, I needed a way to track my builds without constantly checking. Telert lets me focus on coding while keeping me updated on all my background tasks." — Full Stack Developer

"The Python integration is brilliant - I've added @notify decorators to all my critical functions. Now I get alerts when my backend tasks finish or if anything fails." — Backend Engineer

📝 License

Licensed under the MIT License.