I Built a dj_telegram_bot pkg to create Telegram Bot with Django

#!z@nko...; — Tue, 28 Jul 2026 11:56:26 +0000

Hey everyone, especially those of you who are reading these posts and sticking around with me!

For a few years now I've been writing Telegram bots on top of the Django codebase I already had lying around, but at some point I thought — why not just turn this into a proper package? It'd be easier to install and you could get moving on your work way faster.

So that's how dj_telegram_bot came to be — forked from a friend's project, and I pushed it everywhere it needed to go

First stop: Why, why, and... why?

A question that probably crosses everyone's mind:

Why should I use this?
What's actually the point?
What does it even have over the alternatives?

Well, here are a few advantages, and there will be more in future versions.

1 - Simplicity and convenience: if you've worked with Django before, you can build a bot here faster than a "hello world" project 😁 Django's admin panel and ORM handle a ton of the work for you.

2 - Custom admin panel: there's a section of the admin panel built specifically for this library — you can easily add message text and create InlineKeyboardMarkup or ReplyKeyboardMarkup for them.

3 - Type-safe and ready to go: Telegram types are fully validated with pydantic, so you get helpful error hints right in your editor, plus there are some built-in defaults like a sponsor channel and bot status settings.

4 - Flexibility: you can very easily send monitoring, logging, and notifications from your Django site over to Telegram.

Second stop: how do you actually write a bot with it?

Since it's structured as a Django app, to work with it you need to build a Django project first; then add the library to INSTALLED_APPS, You'll also need your own Django app (e.g., created with django-admin startapp bot).

You can find the installation steps and more details either on the library's PyPI page or in the GitHub README!

Here are a few screenshots of how to build a simple bot (there's also a demo video on GitHub).

See how quick it is? This example is literally just copy-pasted from another bot of mine

The message-adding section in the admin panel

Sample bot code

Final bot output

In the example above, I realized changing the "step" is a bit annoying... it'd be better to have a service for the user with an update-step method and so on.

Oh, and the docs are still at version one — if I get the time, adding something with mkdocs would be nice.

If you found this interesting or useful, I'd really appreciate a star on the GitHub ⭐️

If you'd like, you're welcome to contribute to the docs!!

Thanks for sticking with me and reading all the way through, hope you're doing well. Cheers ❤️

https://github.com/zankoAn/dj_telegram_bot

upload local image/video in django TinyMCE text editor.

#!z@nko...; — Thu, 23 Dec 2021 21:20:46 +0000

In the TinyMCE editor, when you want to upload an image, you do not have the option to upload your local image (i.e with the file browser dialog) like this:

to solve this problem you need to edit templates of django admin panel and create new js file for add upload option...

0. Directory Structures

Suppose you have a directory structure like this:



. 
├── core
│   ├── urls.py
│   ├── settings.py
│   └── ...
├── post
│   ├── admin.py
│   ├── models.py
│   └── ...
└── static
    └── js
        └── uploader.js

in this structure you have static directory to store your static file(if you don't have this static file read this page) and now create a js directory and then put the uploader.js file in this directory, But what data should be in this file?👇🏻

1. Add upload feature to TinyMCE editor.

You have to up this js code in uploader.js:



tinymce.init({
      selector: "textarea#id_body",      
      height: "700",
      width: "1300",
      plugins: "insertdatetime media image preview",
      toolbar: "undo redo |  bold italic | alignleft alignright aligncenter alignjustify | image media | preview",
      image_title: true,
      image_caption: true,
      automatic_uploads: true,
      image_advtab: true,
      file_picker_types: "image media",

      file_picker_callback: function (cb, value, meta) {
        var input = document.createElement("input");
        input.setAttribute("type", "file");
        if (meta.filetype == "image") {
            input.setAttribute("accept", "image/*");}
        if (meta.filetype == "media") {
        input.setAttribute("accept", "video/*");}

        input.onchange = function () {     
            var file = this.files[0];
            var reader = new FileReader();
            reader.onload = function () {
                var id = "blobid" + (new Date()).getTime();
                var blobCache =  tinymce.activeEditor.editorUpload.blobCache;
                var base64 = reader.result.split(",")[1];
                var blobInfo = blobCache.create(id, file, base64);
                blobCache.add(blobInfo);
               cb(blobInfo.blobUri(), { title: file.name });
             };
             reader.readAsDataURL(file);
         };
         input.click();
      },
      content_style: "body { font-family:Helvetica,Arial,sans-serif; font-size:14px }"
  });

This script contains small configuration for the TinyMCE editor, if you want more options in the toolbar or add multiple plugins and so on.. you can put your configuration in this file, and you can find all the configuration options in the TinyMCE documentation...

if you want to add more image configuration, you can read this link below:

image

file-image-upload

2. Edit Django AdminPanel

Ok lets edit admin panel template to add TinyMCE editor and upload image/video option.

first you need to find this file and edited:



/django/contrib/admin/templates/admin/change_form.html

This file has the tag {\% endblock \%} in the end line, you must put the following line before this line
‍‍‍‍‍```


This line is to load uploader.js file, which is exactly my js script for adding the image/video upload feature, this line should be added to this file.

---
## 3. Upload Image/Video


Now your job is done! You can save **change_form.html** and reload the admin panel, now the image upload option has been added and you can use it to upload your video and images.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/bpwufgf0rsfvyw04gj3v.png)


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/3o1i2c3pl01hcj2zmtml.png)


---

**Note:**
> If you have the TinyMCE configuration in **settings.py**, after this change in the <u>admin panel</u>, all **TinyMCE** settings will be ignored and the configuration in the <u>uploader.js</u> file will be applied.