cmdop-bot

pip install cmdop-bot

# With Telegram support (aiogram)
pip install "cmdop-bot[telegram]"
 
# With Discord support (discord.py)
pip install "cmdop-bot[discord]"
 
# With Slack support (slack-bolt)
pip install "cmdop-bot[slack]"
 
# With all channels
pip install "cmdop-bot[all]"

# Import Model for AI tier selection and TelegramBot channel
from cmdop_bot import Model
from cmdop_bot.channels.telegram import TelegramBot
 
# Create a Telegram bot instance with authentication and target machine
bot = TelegramBot(
    token="YOUR_TELEGRAM_BOT_TOKEN",       # Bot token from @BotFather
    cmdop_api_key="cmdop_xxx",             # Your CMDOP API key
    allowed_users=[123456789],             # Restrict to specific Telegram user IDs
    machine="my-server",                   # Default target machine hostname
    model=Model.balanced(),                # AI model tier: cheap, balanced, or smart
)
 
# Start the bot (blocking call — runs the aiogram event loop)
bot.run()

# Import the Discord channel integration
from cmdop_bot.channels.discord import DiscordBot
 
# Create a Discord bot with guild-scoped slash commands
bot = DiscordBot(
    token="YOUR_DISCORD_BOT_TOKEN",   # Bot token from Discord Developer Portal
    cmdop_api_key="cmdop_xxx",        # Your CMDOP API key
    guild_ids=[123456789],            # Guild IDs for instant command sync
)
 
# Start the bot (blocking call — runs the discord.py event loop)
bot.run()

# Import the Slack channel integration
from cmdop_bot.channels.slack import SlackApp
 
# Create a Slack app with Socket Mode for real-time events
app = SlackApp(
    bot_token="xoxb-YOUR-BOT-TOKEN",   # Slack bot token (xoxb- prefix)
    app_token="xapp-YOUR-APP-TOKEN",   # Slack app-level token for Socket Mode
    cmdop_api_key="cmdop_xxx",         # Your CMDOP API key
)
 
# Start the Slack app (blocking call — runs the slack-bolt event loop)
app.run()

# Import IntegrationHub for running multiple channels at once
from cmdop_bot import IntegrationHub
from cmdop_bot.channels.telegram import TelegramBot
from cmdop_bot.channels.discord import DiscordBot
 
# Create a hub that manages shared CMDOP connection and target machine
hub = IntegrationHub(cmdop_api_key="cmdop_xxx", machine="my-server")
 
# Register each channel — they share the same CMDOP backend
hub.add_channel(TelegramBot(token="tg_xxx", cmdop_api_key="cmdop_xxx"))
hub.add_channel(DiscordBot(token="dc_xxx", cmdop_api_key="cmdop_xxx"))
 
# Start all channels concurrently (async — use inside an async function)
await hub.start()

Telegram (aiogram) ──┐                     ┌── Shell
Discord (discord.py) ──┤── CMDOPHandler ──┤── Agent
Slack (slack-bolt) ────┘     cmdop SDK    ├── Files    ── Your Servers
                                          └── Skills