---
id: agentex-client
version: "0.24.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# agentex-client — The official Python REST client for the Agentex API

License: permissive · Maintenance: active · Downloads: 76.6K/mo

## What it is and what it does

Agentex-client is an officially maintained Python REST client for the Agentex API, generated using Stainless. It wraps the Agentex REST API with full type annotations for all request parameters and response fields, powered by httpx for HTTP transport and pydantic for response modeling. The library supports both synchronous and asynchronous usage patterns, allowing developers to choose blocking or non-blocking I/O based on their application architecture.

The client handles common API concerns automatically: it retries certain errors (connection failures, timeouts, rate limits, and 5xx responses) with exponential backoff, provides detailed error types for different HTTP status codes, and includes built-in support for debugging temporal projects during local development. Type definitions enable IDE autocomplete and catch errors early, while helper methods on response objects simplify serialization to JSON or dictionaries.

Use it for:

- Build agent orchestration workflows that list, create, or manage tasks via the Agentex API with full type safety.
- Integrate Agentex into async Python services (FastAPI, aiohttp apps) using AsyncAgentex for non-blocking API calls.
- Debug local agent execution with built-in temporal project debugging via CLI commands with configurable debug ports.
- Develop CLI tools or batch scripts that interact with Agentex agents and schedules using the synchronous client.
- Handle API errors gracefully with specific exception types (RateLimitError, AuthenticationError, etc.) for retry logic.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a typed Python REST client for the Agentex API with both synchronous and asynchronous interfaces, automatically generated with full request and response type definitions.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It is the official client for Agentex and provides a modern, typed interface with both sync and async support. Install it if you are building on the Agentex platform.

## Install

pip install agentex-client
uv add agentex-client
poetry add agentex-client

## Installing agentex-client

Before you install: Low friction: pure Python wheel with six lightweight runtime dependencies (anyio, distro, httpx, pydantic, sniffio, typing-extensions). Active maintenance—released 2 days ago with last commit 2026-08-14.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and redistribution with minimal restrictions; suitable for most projects.

Quickstart:

pip install agentex-client

import os
from agentex import Agentex

client = Agentex(api_key=os.environ.get("AGENTEX_SDK_API_KEY"))
tasks = client.tasks.list()

Requires Python 3.11 or later; API key must be set via AGENTEX_SDK_API_KEY environment variable or passed explicitly.

Verify before relying:

- Whether the library's automatic retry logic (2 times by default for connection/timeout/5xx errors) is configurable per-request type.
- Performance characteristics of the async client with httpx versus the optional aiohttp backend under high concurrency.
- Completeness of type coverage for all Agentex API endpoints and response schemas.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

agentex api client python, rest api client library, async http client, typed api wrapper, python sdk generation, httpx-based client, pydantic typed responses, api-client, async-support, type-hints

[View on SkillFed](https://skillfed.io/packages/agentex-client) · [View on PyPI](https://pypi.org/project/agentex-client/)