Long-Running Bots

Run bots 24/7 without memory leaks or silent corruption

Run Telegram, Discord, Slack, and other bots for weeks — bounded lock caches and agent-scoped locks keep memory stable with no extra configuration.

from praisonaiagents import Agent
from praisonai.bots import Bot

agent = Agent(name="assistant", instructions="Be helpful")
bot = Bot("telegram", agent=agent)
bot.run()

The user messages your bot channel; session locks stay bounded while the same agent handles concurrent chats.

How It Works

Quick Start

1. Simple Usage

   from praisonaiagents import Agent
   from praisonai.bots import Bot
   
   agent = Agent(name="assistant", instructions="Be helpful")
   bot = Bot("telegram", agent=agent)
   bot.run()  # Bounded locks are active by default

   Nothing extra is required — debounce, session, and run-control paths share the same bounded per-user lock cache.

2. With Configuration

   from praisonaiagents import Agent
   from praisonaiagents import BotConfig
   from praisonai.bots import Bot
   
   agent = Agent(name="assistant", instructions="Be helpful")
   config = BotConfig(session_ttl=86400)  # Reap idle sessions after 24h
   
   bot = Bot("telegram", agent=agent, config=config)
   bot.run()

What’s Bounded by Default

Operational Knobs

For mid-run cancellation and stale session cleanup, see Bot Run Control — SessionRunControl.cleanup_stale_sessions(max_age_seconds=3600) removes abandoned run-control state.

Multi-Agent Safety

Earlier releases keyed agent locks on id(agent). CPython may reuse that integer after garbage collection, so long-running gateways that recreated agents per request could silently mix up two users’ histories. Agent locks now follow agent lifetime via WeakKeyDictionary; per-user locks stay bounded even if you never call cleanup helpers.

Best Practices

Auto-reconnect (default)

Bot(...).run() now supervises its own inbound connection — if the socket drops, ChannelSupervisor reconnects with capped exponential backoff and restarts an unhealthy channel, matching the resilience BotOS and the gateway already provide.

1. Default supervision on Slack

   from praisonaiagents import Agent
   from praisonai_bot import Bot
   
   agent = Agent(name="Support", instructions="Answer support questions")
   Bot("slack", agent=agent).run()   # auto-reconnects on drop

2. Same code, every platform

   The identical pattern works for Discord, Email, Linear, and WhatsApp — no extra flags:

   from praisonaiagents import Agent
   from praisonai_bot import Bot
   
   agent = Agent(name="Support", instructions="Answer support questions")
   Bot("discord", agent=agent).run()   # supervised too

3. Opt out under an external supervisor

   Set enable_supervision=False when embedding, testing, or running under systemd/k8s:

   from praisonaiagents import Agent
   from praisonai_bot import Bot
   
   agent = Agent(name="Support", instructions="Answer support questions")
   Bot("slack", agent=agent, enable_supervision=False).run()

Which platforms are supervised by default?

When to opt out (enable_supervision=False)

Related