Build Agents, Not Infrastructure
Agentuity Python SDK
Visit https://agentuity.com to get started with Agentuity.
The Agentuity Python SDK is a powerful toolkit for building, deploying, and managing AI agents in Python environments. This SDK provides developers with a comprehensive set of tools to create intelligent, event-driven agents that can process various types of content, communicate with each other, and integrate with external systems.
Key Features
- Multi-Agent Architecture: Build and orchestrate multiple interconnected agents that can communicate and collaborate.
- Event-Driven Design: Respond to various triggers including webhooks, cron jobs, SMS, voice, email, and more.
- Rich Content Handling: Process and generate multiple content types including JSON, text, markdown, HTML, and binary formats (images, audio, PDFs).
- Persistent Storage: Built-in key-value and vector storage capabilities for maintaining state and performing semantic searches.
- Observability: Integrated OpenTelemetry support for comprehensive logging, metrics, and tracing.
- Cross-Runtime Support: Works seamlessly with both Node.js and Bun runtimes.
Use Cases
- Building conversational AI systems
- Creating automated workflows with multiple specialized agents
- Developing content processing and generation pipelines
- Implementing intelligent data processing systems
- Building AI-powered APIs and services
IO Modules
The SDK provides several IO modules for handling different types of input and output:
Process and reply to emails with support for attachments, HTML content, and rich formatting.
Discord
Handle Discord messages and send replies with full integration to Discord's API.
Telegram
Process Telegram messages and send replies with support for typing indicators and message formatting.
from agentuity.io.telegram import Telegram, parse_telegram
# Parse a Telegram message from raw data
telegram_message = await parse_telegram(raw_data)
# Access message properties
print(f"From: {telegram_message.from_first_name}")
print(f"Message: {telegram_message.text}")
# Send a reply
await telegram_message.send_reply(request, context, "Hello! I received your message.")
# Send typing indicator
await telegram_message.send_typing(request, context)
See the examples/telegram_example.py for a complete usage example.
Getting Started
To use this SDK in a real project, you should install the Agentuity CLI.
curl -fsSL https://agentuity.sh | sh
Once installed, you can create a new project with the following command:
agentuity new
Development Setup
Prerequisites
Installation
Clone the repository and install dependencies:
# Clone the repository
git clone https://github.com/agenuity/sdk-py.git
cd sdk-py
# Install dependencies
uv sync
Local Development
Create a new agent project or use an existing one like normal.
To link your local python SDK to your project, run the following commands:
Install the dependencies
make install
Build the SDK:
make build
In your project, install the local SDK build:
uv add ~/path/to/sdk-py/dist/agentuity-0.0.83.post2+d07b43907c8002056fe3550ddef946d1dbb0eeff.tar.gz
Make sure to replace the path with the actual path to the SDK build.
Now you can run your project like normal.
agentuity dev
License
See the LICENSE file for details.
1 maintainer
Metadata
1 maintainer
Release files for agentuity 0.0.106
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agentuity-0.0.106.tar.gz | 183.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agentuity-0.0.106-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 234.4 kB
Release files / agentuity-0.0.106.tar.gz
| Download URL | agentuity-0.0.106.tar.gz |
|---|---|
| Size | 183.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
138fab17585180578becad91d8747156f229bfe315989e084a4f9f82fce79f6a
|
|
BLAKE2b-256 checksum How to use checksums |
74d5b1d64c9798ff5099e3605034c4d44852a76f18c604f9d2848025faa9af07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 3, 2025.
Transparency logRelease files / agentuity-0.0.106-py3-none-any.whl
| Download URL | agentuity-0.0.106-py3-none-any.whl |
|---|---|
| Size | 50.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
46b714e6e1eee1aac767a6f2e76410ef8999aa726c7101b3d853b58690e7ae4b
|
|
BLAKE2b-256 checksum How to use checksums |
98338656a6621ce0e68a9e001049f14bcf439f4bf6b8e70510afb7fd2f460e1a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 3, 2025.
Transparency log
