---
id: orq-ai-sdk
version: "4.13.12"
license: unclear
license_treatment: unclear
maintenance: active
---

# orq-ai-sdk — Python Client SDK for the Orq API.

License: unclear · Maintenance: active · Downloads: 98.8K/mo

## What it is and what it does

orq-ai-sdk is a Python client library for the orq.ai API, designed to provide type-safe, developer-friendly access to orq.ai's services. It wraps HTTP communication using httpx and httpcore, with request/response validation via pydantic. The SDK supports both synchronous and asynchronous workflows, allowing you to query agents, manage alerts, run evaluations, and interact with other orq.ai resources through a consistent interface.

The package is actively maintained and requires Python 3.10 or later. It handles authentication via API key (passed as a parameter or read from the ORQ_API_KEY environment variable), supports streaming responses, file uploads, automatic retries, and custom HTTP client configuration. The SDK is distributed as a pure Python wheel with no compiled dependencies, making installation straightforward across platforms.

Use it for:

- Build Python applications that programmatically create, list, update, or delete AI agents via the orq.ai API.
- Set up monitoring and alerting rules for AI systems by creating and managing alerts through the SDK.
- Run evaluations on AI models or agents and retrieve results asynchronously to avoid blocking application logic.
- Integrate orq.ai capabilities into async Python frameworks (FastAPI, aiohttp) using the native async/await support.
- Automate agent lifecycle management (creation, configuration, deletion) as part of CI/CD or infrastructure-as-code workflows.

## Worth the install?

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

A type-safe Python SDK for the orq.ai API, providing synchronous and asynchronous access to agent management, alerts, evaluations, and related operations.

Yes, if you are building Python applications that need to interact with the orq.ai API. The SDK is actively maintained, has low install friction, and provides both sync and async interfaces. However, verify the license terms before use, as the license status is currently unclear in the package metadata. No known security vulnerabilities are reported.

## Install

pip install orq-ai-sdk
uv add orq-ai-sdk
poetry add orq-ai-sdk

## Installing orq-ai-sdk

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a release on 2026-08-14 and commits through that date. Requires Python 3.10 or later.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before use in proprietary or copyleft-sensitive contexts.

Quickstart:

pip install orq-ai-sdk

from orq_ai_sdk import Orq
import os

with Orq(api_key=os.getenv("ORQ_API_KEY", "")) as orq:
    res = orq.evals.all(limit=10)
    print(res)

Requires Python 3.10 or later and a valid ORQ_API_KEY environment variable or parameter for authentication.

Verify before relying:

- What is the actual license under which this package is distributed?
- Are there any rate limits or quotas enforced by the orq.ai API that users should be aware of?
- What is the stability guarantee for the SDK's public API across versions?

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 98.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

orq.ai python sdk, ai agent management api client, type-safe api sdk python, async http client wrapper, orq api python integration, api-client, async-support, type-safe

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