commandless-relay 0.1.0

Python SDK for Commandless relay API

commandless-relay (Python)

Official Python SDK for the Commandless relay API.

This package gives Python bots a simple client and a ready-to-use discord.py adapter.

Install

Core client:

pip install commandless-relay

With discord.py adapter support:

pip install "commandless-relay[discord]"

Quickstart (discord.py)

import os
import discord
from commandless_relay import RelayClient, use_discord_adapter

TOKEN = os.getenv("BOT_TOKEN")
API_KEY = os.getenv("COMMANDLESS_API_KEY")
BASE_URL = os.getenv("COMMANDLESS_SERVICE_URL")

intents = discord.Intents.default()
intents.message_content = True
intents.messages = True
intents.guilds = True

client = discord.Client(intents=intents)
relay = RelayClient(api_key=API_KEY, base_url=BASE_URL)

use_discord_adapter(client, relay, mention_required=True)

@client.event
async def on_ready():
    print(f"Logged in as {client.user}")

client.run(TOKEN)

Environment variables

• BOT_TOKEN - your Discord bot token
• COMMANDLESS_API_KEY - API key created in Commandless dashboard
• COMMANDLESS_SERVICE_URL - your Commandless backend URL
• COMMANDLESS_HMAC_SECRET - optional HMAC secret

Included components

• RelayClient
  • send_event(event) -> Decision dict or None
  • register_bot(...) -> botId (optional flow)
  • heartbeat() (optional flow)
• use_discord_adapter(client, relay, mention_required=True, execute=None)
  • binds an on_message listener
  • sends events to relay
  • executes reply actions by default
  • sends a clear message on billing rejection (402 / no subscription or credits)