zeroentropy

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 on this page — 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

zeroentropy on PyPI

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

Evidence: zeroentropy-0.1.0a11-py3-none-any.whl

Tags

More Python Modules packages