---
id: arcadepy
version: "1.10.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# arcadepy — The official Python library for the Arcade API

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

## What it is and what it does

Arcadepy is the official Python client for the Arcade REST API, generated using Stainless. It wraps HTTP communication with httpx and provides full type annotations for request parameters and response fields, supporting both synchronous and asynchronous usage patterns. The library handles API authentication via key, includes automatic retry logic for transient failures, and exposes detailed error types for different HTTP status codes.

Developers use it to call Arcade tools (like Google.ListEmails) from Python applications, with the library managing connection pooling, timeouts, and error recovery. It supports modern Python versions from 3.8 onward and can optionally use aiohttp as an alternative HTTP backend for improved async concurrency. Type hints and Pydantic models enable IDE autocomplete and early error detection.

Use it for:

- Execute Arcade tools (e.g., email, calendar, search) from a Python backend service with automatic retries and error handling.
- Build async workflows that call multiple Arcade tools concurrently using AsyncArcade and await syntax.
- Integrate Arcade API calls into existing Python applications with full type safety and IDE support via Pydantic models.
- Handle API errors gracefully by catching specific exception types (RateLimitError, AuthenticationError, etc.) and implementing custom logic.
- Configure per-request timeouts and retry policies for different tool execution scenarios.

## Worth the install?

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

Provides a typed Python client library for the Arcade REST API with both synchronous and asynchronous interfaces, handling authentication, retries, and error management.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides a well-typed, low-friction way to call the Arcade API from Python. Install it if you need to execute Arcade tools from a Python application.

## Install

pip install arcadepy
uv add arcadepy
poetry add arcadepy

## Installing arcadepy

Before you install: Low install friction with a pure-wheel distribution and six lightweight runtime dependencies. The package is actively maintained with recent commits and has been in development since October 2024.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal obligations.

Quickstart:

pip install arcadepy

import os
from arcadepy import Arcade

client = Arcade(api_key=os.environ.get("ARCADE_API_KEY"))
response = client.tools.execute(
    tool_name="Google.ListEmails",
    input={"n_emails": 10},
    user_id="user@example.com",
)
print(response.id)

Requires an Arcade API key (typically set via ARCADE_API_KEY environment variable); Python 3.8 or later.

Verify before relying:

- Whether the library's type coverage is complete across all Arcade API endpoints and response models.
- Performance characteristics and concurrency limits when using the async client at scale.
- Specific retry behavior and backoff strategy details beyond the stated 2 default retries.

## Package facts

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

## Tags

arcade api client python, rest api client library, async http client wrapper, typed api sdk, arcade tool execution, api-client, async-support, type-hints

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