Disclaimer: This blog post is not affiliated with or endorsed by Telegram. As part of our workflow experimentation in the DEPRIMAP project, we explored multiple ways to receive remote notifications for long-running Jupyter Notebook tasks. Among the options tested, Telegram offered the simplest and secure implementation with minimal setup. We are sharing this solution purely as a practical tip based on our experience.<\/code><\/em><\/p>\n\n\n\nHave you ever found yourself waiting around for a Jupyter Notebook cell to finish running? Maybe you are training a large model, exporting data from cloud servers, or processing heavy geospatial files. You step away for a coffee or switch to another task, only to return much later, unsure if your code finished 10 seconds ago or 10 minutes ago.<\/p>\n\n\n\n
In large-scale projects like DEPRIMAP, where notebooks can take time to execute due to high-resolution geospatial datasets or remote API requests, this is more than just an inconvenience; it’s a break in workflow.<\/p>\n\n\n\n
That’s where Telegram<\/strong> comes in.<\/p>\n\n\n\nIn this guide, I’ll show you how to:<\/p>\n\n\n\n
\n- Set up a Telegram bot<\/li>\n\n\n\n
- Connect it to your Jupyter notebook<\/li>\n\n\n\n
- Receive a message when your code completes<\/li>\n<\/ul>\n\n\n\n
All using a few lines of Python and zero third-party dependencies beyond ‘requests’.<\/p>\n\n\n\n
No need to configure email servers or expose passwords. Telegram is fast, secure, and already on your phone (hopefully), so why not let it tell you when your code is done?<\/p>\n\n\n\n
Github Repository link:<\/strong> https:\/\/github.com\/saiga143\/telegram-jupyter-notify<\/a><\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/github-repo-screenshot-1-1024x721.jpg\")
<\/figure>\n\n\n\n
\n\n\n\nWhat You’ll Need<\/strong><\/h3>\n\n\n\nYou don’t need any complex setup or heavy libraries to make this work. Just a few basic tools:<\/p>\n\n\n\n
a) A Telegram account<\/strong><\/p>\n\n\n\nIf you’re reading this on your phone, chances are you already have one. If not, download the Telegram app from the Play Store<\/a> or App Store<\/a>, or use the web version<\/a>.<\/p>\n\n\n\nb) Access to Jupyter Notebook<\/strong><\/p>\n\n\n\nThis can be:<\/p>\n\n\n\n
\n- A local Jupyter environment (Anaconda, JupyterLab, VS Code, etc.)<\/li>\n\n\n\n
- A hosted environment (like Binder, Colab, or a remote server).<\/li>\n<\/ul>\n\n\n\n
c) Python’s ‘requests’ Library<\/strong><\/p>\n\n\n\nThis handles sending the actual message to Telegram. You can install it by running:<\/p>\n\n\n\n
pip install requests<\/strong><\/code><\/pre>\n\n\n\nThat’s all – no need for email server configs or messaging API subscriptions.<\/p>\n\n\n\n
\n\n\n\n\u2699\ufe0fStep-by-Step Setup<\/strong><\/h3>\n\n\n\nIn this section, we’ll walk through how to:<\/p>\n\n\n\n
\n- Create your own Telegram bot<\/li>\n\n\n\n
- Get your unique chat ID<\/li>\n\n\n\n
- Connect it to a Python function<\/li>\n\n\n\n
- Send your first notification from a Jupyter Notebook<\/li>\n<\/ul>\n\n\n\n
Step 1: Create a Telegram Bot<\/strong><\/p>\n\n\n\n1. Open the Telegram App<\/p>\n\n\n\n
2. In the search bar, type and select ‘@BotFather<\/strong>‘<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-4.png\")
<\/figure>\n\n\n\n3. Click ‘Start’ to begin<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-5-1024x922.png\")
<\/figure>\n\n\n\n4. Then type ‘\/newbot’ and follow the prompts:<\/p>\n\n\n\n
\n- Give your bot a name<\/strong> (e.g., ‘jupyter_notify_bot’)<\/li>\n\n\n\n
- Give it a username<\/strong> (must end in ‘bot’, like ‘notifier_xyz_bot’)<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-6-1024x577.png\")
<\/figure>\n\n\n\n\ud83e\udeaa Once done, BotFather will send you a message that contains an API token that looks like the image below. <\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-7-955x1024.png\")
<\/figure>\n\n\n\nThe code highlighted in the yellow box is your API token.<\/p>\n\n\n\n
\ud83d\udcccCopy this token somewhere safe – it’s what allows your code to send you messages.<\/p>\n\n\n\n
Step 2: Start a Chat with your Bot<\/strong><\/p>\n\n\n\n1. In Telegram, search for the bot you just created by its username (or you can also click on the link mentioned in the previous message, which mentions your API token.<\/p>\n\n\n\n
2. Click Start to activate the bot.<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-8-1024x926.png\")
<\/figure>\n\n\n\n3. Send it a message – even a simple ‘hi’ will do.<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-9-982x1024.png\")
<\/figure>\n\n\n\nThis is important. Telegram only allows bots to send messages to users who’ve initiated a chat.<\/em><\/p>\n\n\n\nStep 3: Get Your Chat ID<\/strong><\/p>\n\n\n\nTo send yourself a message, you need your unique chat ID.<\/p>\n\n\n\n
1. Open the link below in your browser (replace ‘<YOUR_TOKEN>’) with your API token:<\/p>\n\n\n\n
https:\/\/api.telegram.org\/bot<YOUR_TOKEN>\/getUpdates<\/strong><\/code><\/pre>\n\n\n\nSo it looks something like this:<\/p>\n\n\n\n
https:\/\/api.telegram.org\/bot8070205656:AAEnxNEtUpdTtbK2z7NIqni5W5UpLK-K984<\/code>\/getUpdates<\/strong><\/p>\n\n\n\nWhen you open the above link in your browser, you should see something like below (if you don’t see that, send another message to your bot and refresh the page)<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-10-1024x502.png\")
<\/figure>\n\n\n\n\ud83d\udd0d The number next to ‘id’ under ‘chat’ shown using the orange arrow in the above picture is your chat ID.<\/p>\n\n\n\n
Copy it – you’ll use it in your Python script.<\/p>\n\n\n\n
Step 4: Add the Notification Function to Your Notebook<\/strong><\/p>\n\n\n\nNow it’s time this into your Jupyter Notebook. Refer to the ‘telegram_notify_example.ipynb’ file in the GitHub repo<\/a>, which contains the following function. Replace the token and chat ID with your API token ID and chat ID, respectively.<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-11-1024x583.png\")
<\/figure>\n\n\n\n\ud83e\udde0 Tip: <\/strong>Keep this function cell near the top of your notebook so you can reuse it easily.<\/p>\n\n\n\nStep 5: Send a Message When Your Task Finishes<\/strong><\/p>\n\n\n\nAfter any cell or block of code that takes time, you can trigger the bot to notify you. Below is a basic example use case.<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-12-1024x229.png\")
<\/figure>\n\n\n\n\ud83d\udd27 Customise it by:<\/p>\n\n\n\n
\n- Changing the message text<\/li>\n\n\n\n
- Embedding timestamps<\/li>\n\n\n\n
- Adding emojis to signal success\/failure visually<\/li>\n<\/ul>\n\n\n\n
You can even wrap this into a function to notify only on error. All examples are shown in the Jupyter notebook in the GitHub repo<\/a>.<\/p>\n\n\n\nBelow is an example picture of how the notifications look in the Telegram app.<\/p>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2025\/07\/image-14-934x1024.png\")
<\/figure>\n\n\n\n
\n\n\n\n\ud83c\udf0dUse Cases for Research Workflows<\/strong><\/h3>\n\n\n\nSo, where does this fit into your workflow?<\/p>\n\n\n\n
Here are a few common situations, especially in data-heavy, geospatial, or machine learning projects, where a Telegram bot notification can be a game-changer:<\/p>\n\n\n\n
\ud83d\udef0\ufe0fEarth Observation Tasks<\/strong><\/p>\n\n\n\nWhen exporting large image collections or processing satellite imagery, cell execution can take several minutes or hours. Instead of checking repeatedly, let Telegram alert you when the export or processing is complete.<\/p>\n\n\n\n
\ud83e\udde0Model Training<\/strong><\/p>\n\n\n\nWhether it’s a deep learning model for slum detection or a Random Forest Classifier, training time varies widely based on data and parameters. You can insert a Telegram notification once the model finishes running or achieves a certain validation score.<\/p>\n\n\n\n
\ud83d\uddfa\ufe0fGeospatial Analysis<\/strong><\/p>\n\n\n\nOperations like zonal statistics, projection, tiling, or merging large raster\/vector files can be heavy. If your notebooks handle global-scale or high-resolution city data (as in DEPRIMAP), even simple joins can take minutes. Add a notification at the end and free yourself from waiting.<\/p>\n\n\n\n
\ud83e\uddeaBatch Jobs and Experiments<\/strong><\/p>\n\n\n\nWhen running parameter sweeps or looping through datasets for multiple countries\/cities, insert a notification after each iteration to monitor progress, especially useful when working with remote or headless servers.<\/p>\n\n\n\n
\ud83d\udc69\u200d\ud83d\udcbbRemote Notebooks<\/strong><\/p>\n\n\n\nIf your Jupyter Notebook is hosted on a cloud VM, university server, or even Google Colab, Telegram lets you stay updated without needing to keep the browser tab open.<\/p>\n\n\n\n
This tiny automation can save hours of passive waiting and keep you informed even while multitasking, away from your desk, or working on other parts of your project.<\/p>\n\n\n\n
\n\n\n\nClosing Thoughts<\/strong><\/h3>\n\n\n\nThis Telegram notification setup is simple, secure, and surprisingly effective.<\/p>\n\n\n\n
In research workflows like those in DEPRIMAP, where processing tasks can be long, unpredictable, and distributed, small automation like this help keep focus where it matters. Instead of checking your notebook tab every few minutes, you’ll get a message on your phone the moment it’s done. Telegram is easy to use, has cross-platform support, and has privacy; no need to deal with email servers or share passwords.<\/p>\n\n\n\n
It takes just 5-10 minutes to set up and can save hours of passive waiting over time. <\/p>\n\n\n\n
If you’re interested in trying it out, you can start with the example notebook and code from our GitHub repo. Feel free to adapt it to your own case, and if you build on top of this idea (e.g., notify on errors, looped batches, etc), we’d love to hear how you’ve extended it.<\/p>\n\n\n\n
Happy coding – and happy not waiting!\ud83d\udd14<\/p>\n\n\n\n
\ud83d\udd17 GitHub Repository<\/strong><\/p>\n\n\n\nhttps:\/\/github.com\/saiga143\/telegram-jupyter-notify<\/a><\/p>\n\n\n\n
![\"DEPRIMAP\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2024\/09\/cropped-cropped-deprimap-site-icon.png\"){kind=icon}
<\/a><\/div>\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2024\/09\/Formas-logo-300x44.png\"){kind=logo}
<\/figure>\n\n\n\n![\"\"](\"https:\/\/sola.kau.se\/deprimap\/wp-content\/uploads\/sites\/1170\/2024\/09\/Karlstad-university-logo-300x300.jpg\"){kind=logo}
<\/figure>\n<\/div>\n\n\n\n