Metadata-Version: 2.4
Name: spear-ai-horizon-sdk
Version: 8.1.1
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Summary: PyO3 Python bindings for the Horizon SDK
Keywords: Horizon,SDK,Spear AI
Author-email: Spear AI <org@spear.ai>
License-Expression: LicenseRef-Proprietary
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# spear-ai-horizon-sdk (Python bindings)

Python bindings for the Horizon Rust SDK, the data access layer for the Horizon
tactical data platform. The bindings are built with [PyO3](https://pyo3.rs) and
[maturin](https://www.maturin.rs), and expose the SDK's PostgreSQL, Kafka, and
Apache Iceberg data paths to Python callers.

The distribution is named `spear-ai-horizon-sdk` and the importable module is
`horizon_sdk`.

## Installation

```bash
pip install spear-ai-horizon-sdk
```

Wheels are published for `aarch64` Linux and for both `arm64` and `x86_64`
macOS. The bindings use the CPython stable ABI (`abi3`), so a single wheel per
platform supports Python 3.11 and newer. On other platforms, build from source
with a Rust toolchain (see the repository for details).

## Usage

```python
import horizon_sdk
```

## Development

This package lives in the [Horizon monorepo](https://github.com/spear-ai/horizon)
at `packages/horizon-sdk/crates/horizon-ffi-python`. The Rust crate it wraps is
at `packages/horizon-sdk/crates/horizon-sdk`.

