Metadata-Version: 2.4
Name: aion-news-to-signal
Version: 0.1.2
Summary: Python client for the AION News-to-Signal API for Indian markets
Author: AION Analytics
License: AGPL-3.0-or-later
Project-URL: Homepage, https://github.com/AION-Analytics/market-sentiments
Project-URL: Documentation, https://huggingface.co/spaces/AION-Analytics/aion-news-to-signal
Project-URL: Issues, https://github.com/AION-Analytics/market-sentiments/issues
Keywords: india,nse,stock-market-news-analysis,trading-signals,financial-news,sentiment-analysis,sector-analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31

# aion-news-to-signal

Thin Python client for the public AION News-to-Signal endpoint.

AION converts Indian financial news into signals for Indian financial markets, NSE workflows, and news-based trading India use cases.

AION converts Indian financial news into:

- event classifications
- sector-level trading signals
- which sectors to long or short
- stakeholder views

This first PyPI release is intentionally minimal. It does not bundle model
weights. It calls the live hosted endpoint:

- Space: `https://huggingface.co/spaces/AION-Analytics/aion-news-to-signal`
- App: `https://aion-analytics-aion-news-to-signal.hf.space`

## Install

```bash
pip install aion-news-to-signal
```

## Quick Start

```python
from aion import analyze

result = analyze("RBI hikes repo rate by 25 bps")
print(result["event"])
print(result["trade_direction_signals"])
```

Also supported:

```python
from aion_news_to_signal import analyze
```

## Hosted API Notes

The current public endpoint is backed by a Hugging Face Space, so the client
uses the Gradio API flow internally.

Measured on `2026-04-26`:

- cold start proxy: `~1.68 s`
- warm latency average: `~716.6 ms`

## Links

- GitHub: `https://github.com/AION-Analytics/market-sentiments`
- Hosted API: `https://aion-analytics-aion-news-to-signal.hf.space`
