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.

Metadata

Release files for clovord.py 0.1.38

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clovord.py 0.1.38
File	Size	Uploaded
clovord_py-0.1.38.tar.gz	49.6 kB	Oct 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for clovord.py 0.1.38
File	Interpreter	ABI	Platform	Reset
clovord_py-0.1.38-py3-none-any.whl 58.4 kB Oct 17, 2026	Python 3	none	any	Details

Total release size: 108.1 kB

Release files / clovord_py-0.1.38.tar.gz

Download URL	clovord_py-0.1.38.tar.gz
Size	49.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`4e721875495cce48cfa5f7ed58e1ae22e56355010ccc856ea368b9bccd274b61`
BLAKE2b-256 checksum How to use checksums	`889bd97333894078ff0ff6e1e45e5e09c17235303cc9c6d12110a5c0e247c10e`
Upload date	Oct 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Clovord/Library---py---clovord.py
Publishing commit: github.com/Clovord/Library---py---clovord.py/tree/bb16bc2a54b05d36a4dede6f7a9cb150f7e7ca6c

Workflow

Publishing configuration: github.com/Clovord/Library---py---clovord.py/blob/bb16bc2a54b05d36a4dede6f7a9cb150f7e7ca6c/.github/workflows/release.yml
Publishing logs: github.com/Clovord/Library---py---clovord.py/actions/runs/39042426083/attempts/1

Artifact

Subject: clovord_py-0.1.38.tar.gz
SHA-256 checksum: 4e721875495cce48cfa5f7ed58e1ae22e56355010ccc856ea368b9bccd274b61 Verifying attestations

Release files / clovord_py-0.1.38-py3-none-any.whl

Download URL	clovord_py-0.1.38-py3-none-any.whl
Size	58.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`47b6cb7c25f32b0eb6cd8098589e0a75936db1dcc216c7977b3481124543cae1`
BLAKE2b-256 checksum How to use checksums	`dd4107da6d1374fe122a836fce2598766b8f7e84647d3329ebab1f763eef6ed8`
Upload date	Oct 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Clovord/Library---py---clovord.py
Publishing commit: github.com/Clovord/Library---py---clovord.py/tree/bb16bc2a54b05d36a4dede6f7a9cb150f7e7ca6c

Workflow

Publishing configuration: github.com/Clovord/Library---py---clovord.py/blob/bb16bc2a54b05d36a4dede6f7a9cb150f7e7ca6c/.github/workflows/release.yml
Publishing logs: github.com/Clovord/Library---py---clovord.py/actions/runs/39042426083/attempts/1

Artifact

Subject: clovord_py-0.1.38-py3-none-any.whl
SHA-256 checksum: 47b6cb7c25f32b0eb6cd8098589e0a75936db1dcc216c7977b3481124543cae1 Verifying attestations