Metadata-Version: 2.4
Name: atheon-codex
Version: 0.5.0
Summary: Python SDK for Atheon
Project-URL: homepage, https://atheon.ad/
Project-URL: repository, https://github.com/atheon-inc/atheon-codex
Project-URL: documentation, https://github.com/atheon-inc/atheon-codex
Author-email: Saurabh Ghanekar <ghanekarsaurabh8@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE.md
Requires-Python: >=3.10
Requires-Dist: httpx>=0.28
Requires-Dist: pydantic>=2.10
Description-Content-Type: text/markdown

# Codex: Python SDK for Atheon

The Atheon Codex Python library provides convenient access to the Atheon Gateway Ad Service from any Python 3.10+ applications. The library includes type definitions for all request params and response fields, and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).

## Installation

```sh
# install from PyPI
pip install atheon-codex
```

## Usage

```python
import os
from atheon_codex import AtheonCodexClient, AtheonUnitFetchAndIntegrateModel

client = AtheonCodexClient(
    api_key=os.environ.get("ATHEON_CODEX_API_KEY"),
)

fetch_and_integrate_payload = AtheonUnitFetchAndIntegrateModel(
    query="How can I write blogs for my website?",
    base_content="insert the llm response generated from your application as the base content",
    # use_user_intent_as_filter=True,
)
result = client.fetch_and_integrate_atheon_unit(fetch_and_integrate_payload)

print(result)
```

>> **Note:** _You can enable monetization through [Atheon Gateway Dashboard](https://gateway.atheon.ad) under project settings._


While you can provide an `api_key` keyword argument, we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/) (or something similar) to add `ATHEON_CODEX_API_KEY="My Eon API Key"` to your `.env` file so that your API Key is not stored in source control.