athenaintel

What it is and what it does

athenaintel is a Python client library for the Athena Intelligence API. It wraps HTTP communication via httpx and provides type-safe request and response models built on Pydantic, covering agent invocation, long-running workflow execution, and thread status queries. The library exports both synchronous and asynchronous clients, allowing blocking and non-blocking API calls respectively.

The package is designed for developers integrating Athena Intelligence services into Python applications. It handles authentication via API key, request/response serialization, timeout configuration, custom HTTP client setup (including proxies), and standardized error handling through an ApiError base class. The library supports Python 3.9 through 3.12 and depends on fastapi, httpx, langchain_core, langserve, and Pydantic for its core functionality.

Use it for:

• Invoke general-purpose agents with custom tool configurations and message histories via the synchronous client.
• Execute long-running workflows asynchronously and poll their status by thread ID.
• Build non-blocking integrations using the async client for concurrent API calls in event-driven applications.
• Customize HTTP behavior (proxies, transports, timeouts) by injecting a custom httpx client instance.
• Handle API errors uniformly by catching exceptions and inspecting status codes and response bodies.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python client library for calling the Athena Intelligence API, with type-safe request/response definitions and both synchronous and asynchronous HTTP clients.

Yes, if you are building a Python application that needs to call the Athena Intelligence API. The package is actively maintained, has low install friction, and provides both sync and async clients with full type safety. The main caveat is that the license is undeclared—verify the actual terms before use. The SDK is also in Preview status, so pin a specific version to avoid breaking changes.

Install

athenaintel on PyPI

pip install athenaintel

uv add athenaintel

poetry add athenaintel

Installing athenaintel

Before you install

Low install friction with a pure-wheel distribution. Actively maintained with a recent release. Eight runtime dependencies including fastapi, httpx, and langchain_core are all well-established packages.

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 restricted projects.

Quickstart

pip install athenaintel

from athenaintel.client import Athena

client = Athena(api_key="YOUR_API_KEY")
response = client.agents.general.invoke(
    request=GeneralAgentRequest(
        config=GeneralAgentConfig(enabled_tools=[]),
        messages=[InputMessage(role="user", content="Hello")]
    )
)
print(response.messages[-1].content)

Requires an Athena Intelligence API key (defaults to ATHENA_API_KEY environment variable).

Verify before relying

• Stability guarantees: description notes SDK is in Preview with potential breaking changes between versions without major version bump.
• Whether the package is auto-generated and how that affects bug-fix responsiveness.
• Actual license terms and any restrictions on commercial use.
• Complete import paths and available request/response model classes beyond those shown in examples.

Package facts

Evidence: athenaintel-0.1.2224-py3-none-any.whl

Tags

More Python Modules packages