Metadata-Version: 2.4
Name: noosphere-sdk
Version: 1.0.0
Summary: Noosphere Prime SIGMA Engine — sovereign risk intelligence for Python
Author-email: Noosphere Prime <api@noosphereprime.space>
License: MIT
Project-URL: Homepage, https://noosphereprime.space
Project-URL: Documentation, https://noosphereprime.space/docs
Project-URL: Repository, https://github.com/noosphereprime/noosphere-sdk-python
Project-URL: Bug Tracker, https://github.com/noosphereprime/noosphere-sdk-python/issues
Keywords: sovereign risk,country risk,geopolitical analysis,financial intelligence,SIGMA engine,regime analysis,emerging markets,political risk,quantitative finance
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
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: License :: OSI Approved :: MIT License
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Provides-Extra: async
Requires-Dist: httpx>=0.27; extra == "async"
Provides-Extra: pandas
Requires-Dist: pandas>=2.0; extra == "pandas"

# noosphere-sdk

**Sovereign risk intelligence for Python** — powered by the [Noosphere Prime](https://noosphereprime.space) SIGMA Engine.

```bash
pip install noosphere-sdk
```

## Quickstart

```python
from noosphere import NoosphereClient

client = NoosphereClient()  # free public API, no key required

# Single country score
score = client.sigma("turkey")
print(score)
# 🇹🇷 Turkey | SIGMA 71.2/100 [CRITICAL] ⚠ EWS

# Deep regime analysis
analysis = client.regime("argentina")
print(f"Collapse probability: {analysis.collapse_probability:.1%}")
print(f"Minsky phase: {analysis.minsky_phase}")
print(f"Hurst exponent: {analysis.hurst_exponent:.4f}")

# Compare multiple entities
results = client.compare(["turkey", "argentina", "italy", "france"])
print(results.summary())
# Risk Ranking (highest → lowest):
#   1. Turkey — 71.2 [CRITICAL] ⚠
#   2. Argentina — 68.4 [STRESS]
#   3. Italy — 52.1 [WARNING]
#   4. France — 47.3 [STABLE]

# List all available entities
entities = client.list_entities()
print([e.slug for e in entities])
```

## Async support

```python
import asyncio
from noosphere import AsyncNoosphereClient

async def main():
    async with AsyncNoosphereClient() as client:
        turkey, argentina = await asyncio.gather(
            client.sigma("turkey"),
            client.sigma("argentina"),
        )
        print(turkey, argentina)

asyncio.run(main())
```

## Authenticated access (higher rate limits)

```python
client = NoosphereClient(api_key="your-api-key")
```

Get an API key at [noosphereprime.space](https://noosphereprime.space).

## Available entities

Call `client.list_entities()` or visit the [public API](https://noosphereprime.space/api/public/sigma).

Countries include: `turkey`, `argentina`, `ukraine`, `italy`, `france`, `germany`, `united-states`, `european-union`, `romania`, `hungary`, `poland`, and 10+ more.

Sectors include: `banking`, `sovereign-debt`, `real-estate`, `energy`, `technology`, `emerging-markets`.

## Attribution

Required: include a link to [noosphereprime.space](https://noosphereprime.space) when displaying scores publicly (CC-BY-4.0).
