---
id: zeroentropy
version: "0.1.0a11"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# zeroentropy — The official Python library for the ZeroEntropy API

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

## What it is and what it does

ZeroEntropy is an official Python SDK that wraps the ZeroEntropy REST API with type-safe request and response handling. It provides both synchronous and asynchronous clients built on httpx, with full type hints for all parameters and responses using Pydantic models and TypedDicts. The library handles common API patterns like automatic pagination, error classification (connection errors, rate limits, authentication failures), and automatic retries for transient failures.

The package is designed for developers integrating document management and collection operations into Python applications. It supports environment-based API key configuration, offers helper methods for serializing responses to JSON or dictionaries, and provides granular control over pagination when needed. An optional aiohttp backend is available for improved async concurrency performance.

Use it for:

- Add, retrieve, and manage documents in named collections via a type-safe Python interface.
- Build async-first applications that interact with ZeroEntropy without manual HTTP request handling.
- Iterate through large paginated result sets automatically without manual page-fetching logic.
- Handle API errors with specific exception types (rate limits, authentication, server errors) for targeted retry logic.
- Integrate ZeroEntropy into existing Python projects with full IDE autocomplete and type checking support.

## Worth the install?

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

Type-safe Python client for the ZeroEntropy REST API, with synchronous and asynchronous support and automatic pagination.

Yes, with conditions. The package is actively maintained, has low install friction, and offers solid type safety and async support. However, it is in pre-release (0.1.0a11), so expect potential breaking changes; use it in production only if you can tolerate version pinning and monitor releases. For new projects or internal tools, it is a reasonable choice.

## Install

pip install zeroentropy
uv add zeroentropy
poetry add zeroentropy

## Installing zeroentropy

Before you install: Low install friction with a pure-wheel distribution and six common dependencies. Active maintenance with a recent commit on 2026-05-13 and regular releases; however, the package is in pre-release (0.1.0a11), so breaking changes may occur.

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

Quickstart:

pip install zeroentropy

import os
from zeroentropy import ZeroEntropy

client = ZeroEntropy(api_key=os.environ.get("ZEROENTROPY_API_KEY"))
response = client.documents.add(
    collection_name="example_collection",
    content={"type": "text", "text": "Example Content"},
    path="my_document.txt",
)
print(response.message)

Requires Python 3.9 or later and a valid ZeroEntropy API key from https://dashboard.zeroentropy.dev/.

Verify before relying:

- Whether the pre-release status (0.1.0a11) indicates API stability or ongoing breaking changes.
- Performance characteristics of automatic pagination for large result sets.
- Support for optional aiohttp backend and its performance trade-offs versus httpx.

## Package facts

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

## Tags

zeroentropy api client, python rest api sdk, async http client library, type-safe api wrapper, document collection management, api pagination helper, rest-api-client, async-support, type-safe

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