Metadata-Version: 2.4
Name: helix-python
Version: 0.2.0
Summary: Official Helix SDK — market grounding for AI agents
Project-URL: Homepage, https://helixread.com
Project-URL: Documentation, https://helixread.com/developers
Author-email: Helix <hello@helixread.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,finance,grounding,helix,llm,market-data
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Requires-Dist: requests>=2.28
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# helix-python

Official Python SDK for [Helix](https://helixread.com) — market grounding for AI agents.

## Install

```bash
pip install helix-python
```

Grab a free API key (250 requests/day, no card) at [helixread.com](https://helixread.com).

## Quickstart

```python
from helix import HelixClient

hx = HelixClient(api_key="hx_...", base_url="https://helixread.com")
ctx = hx.get_context(["NVDA", "AMD"], depth="deep", citations=True)
print(ctx["regime"], ctx.get("peers"))
```

## Features (v0.2.0)

- `get_context()` — depth, modules, since-diff, citations
- `create_session()` / `refresh_session()` — versioned grounding
- `guard_validate()` — Helix Guard anti-hallucination
- `register_webhook()`, `set_watchlist()`, `personal_brief()`
- `regime_history()` — Research API tier

## Starter agents

Download agent zips from [helixread.com/agents](https://helixread.com/agents) (free API key required).

## Docs

- API reference: https://helixread.com/developers
- OpenAPI: https://helixread.com/docs