clovord

A Python SDK for interacting with the Clovord Gateway and REST API.

Installation

pip install clovord

For local development:

pip install -e .[dev]

Usage

import clovord
import os
from clovord import Bot
import json


intents = clovord.Intents.default()
intents.members = True
intents.messages = True
intents.presence = True

bot = Bot(intents=intents)

@bot.event
async def on_ready():
    print("READY EVENT FIRED")

bot.run(os.environ["BOT_TOKEN"])

Overview

Bot is the main entrypoint.
The Gateway connection is handled internally with heartbeat and reconnect support.
The REST client is asynchronous and available through bot.http.

Extensions (Cogs-like)

clovord.py supports extension modules via setup(bot).

# handlers/message_create.py
def setup(bot):
    @bot.event
    async def on_message_create(message):
        if bot.user and message.author.id == bot.user.id:
            return

        if message.content.startswith("!"):
            await message.channel.send(
                "Hello from extension",
                embeds=[{"title": "Welcome", "description": "Embed support"}],
                container={"type": "card", "accent": "brand"},
            )

from pathlib import Path
from clovord import Bot

bot = Bot()

# Load one importable module
bot.load_extension("mybot.handlers.message_create")

# Load multiple modules
bot.load_extensions(
    "mybot.handlers.message_create",
    "mybot.handlers.ready",
)

# Load all modules from a package (and subpackages)
bot.load_extensions_from_package("mybot.handlers")

# Load all modules from a folder path (and subfolders)
bot.load_extensions_from_path(Path(__file__).parent / "handlers")

Latest Release Notes

Version: 0.1.13 Last commit: fix: update version to 0.1.13 in pyproject.toml

Fixed

update version to 0.1.13 in pyproject.toml

Docs

update for v0.1.13dev4

See full history in CHANGELOG.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clovord_py-0.1.25.tar.gz (32.0 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

clovord_py-0.1.25-py3-none-any.whl (34.6 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file clovord_py-0.1.25.tar.gz.

File metadata

Download URL: clovord_py-0.1.25.tar.gz
Upload date: Aug 26, 2026
Size: 32.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for clovord_py-0.1.25.tar.gz
Algorithm	Hash digest
SHA256	`0a44db09eaa071e783e909e2595f66311223b5a1d3eb43b37de7771cc53f988a`
MD5	`7f57782d7aafb38988bf0df68e828668`
BLAKE2b-256	`adf4320fc6ff59cf906995cf42c11be9a613327ef986bf0eb744799707634759`

See more details on using hashes here.

Provenance

The following attestation bundles were made for clovord_py-0.1.25.tar.gz:

Publisher: release.yml on Clovord/Library---py---clovord.py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: clovord_py-0.1.25.tar.gz
- Subject digest: 0a44db09eaa071e783e909e2595f66311223b5a1d3eb43b37de7771cc53f988a
- Sigstore transparency entry: 2605872764
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: Clovord/Library---py---clovord.py@70504b1abe17570cae4157ef01d3f850993ec3dc
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Clovord
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@70504b1abe17570cae4157ef01d3f850993ec3dc
- Trigger Event: push