🔥 Hot Reload

Raito automatically reloads routers on file changes in development mode. This means you can edit handlers and see your updates instantly — without restarting.

How it works

  • Hot reload is enabled by default when you set production=False:

    raito = Raito(dispatcher, routers_dir="src/handlers", production=False)
  • During raito.setup(), Raito:

    1. Scans your routers_dir for Python files

    2. Skips files starting with _

    3. Dynamically imports all routers (with router = Router(...))

    4. Starts a watchdog using watchfiles.awatch

    5. Tracks file changes and reloads the corresponding routers

  • No need to manually call include_router() or manage imports

Example

from aiogram import Router
from aiogram.types import Message
from aiogram.filters import Command

router = Router(name="debug")

@router.message(Command("debug"))
async def debug_handler(message: Message):
    await message.answer("Hello, this is a live-reloading handler!")

Edit the message and hit save — it will reload automatically.

What happens on file change?

  • If a .py file is modified or created:

    • The corresponding router is unloaded and loaded

  • If a .py file is deleted:

    • The router is unregistered

Each router is uniquely tracked by Router.name.

Telegram Raito Commands

You can also manage routers manually via Telegram chat:

  • .rt routers — List all registered routers

  • .rt unload <router_name> — Unload a router by name

  • .rt load <router_name> — Load a router by name

  • .rt reload <router_name> — Reload an existing router

Limitations

  • Changes to shared modules (e.g. utils/, models/) do not trigger reloads

  • Reloads affect only files in routers_dir

  • If a router has side-effects at the top level (e.g., DB queries) — they may run twice