Metadata-Version: 2.4
Name: circle-intelligence
Version: 0.1.0
Summary: Python SDK for Circle Intelligence — F.I.R.E. economy real-time signal detection
Author-email: Circle Intelligence <dev@circle.news>
License: MIT
Project-URL: Homepage, https://circle.news
Project-URL: Documentation, https://circle.news/docs
Project-URL: Repository, https://github.com/Menexus-GmbH/circle_platform_backend
Keywords: circle,intelligence,fire,signals,knowledge-graph,defi
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28
Provides-Extra: wallet
Requires-Dist: eth-account>=0.10; extra == "wallet"
Provides-Extra: payment
Requires-Dist: eth-account>=0.10; extra == "payment"
Requires-Dist: web3>=6.0; extra == "payment"

# Circle Intelligence SDK

Python SDK for [Circle Intelligence](https://circle.news) — real-time F.I.R.E. economy signal detection via 7-agent AI cascade.

## Install

```bash
pip install circle-intelligence              # core (browsing, search, chat)
pip install circle-intelligence[wallet]       # + wallet authentication
pip install circle-intelligence[payment]      # + USDC payment flow
```

## Quick Start

```python
from circle_intelligence import CircleSDK

# Free tier — no auth needed
sdk = CircleSDK("https://circle.news")
signals = sdk.get_recent_signals(limit=3)
entities = sdk.get_kg_entities(search="Bitcoin")
briefs = sdk.get_briefs(limit=5)

# Premium tier — with API key
sdk = CircleSDK("https://circle.news", api_key="circ_your_key")
results = sdk.search_signals("DeFi bridge exploit")
analytics = sdk.get_kg_analytics(days=7)
response = sdk.chat(signal_id=1744, messages=[{"role": "user", "content": "What happened?"}])
```

## Features

| Feature | Free | Premium |
|---------|------|---------|
| Recent signals | 6h delay, 3 max | Real-time, 100 max |
| Daily briefs | Yes | Yes |
| Knowledge graph browsing | Yes | Yes |
| KG analytics + cross-sector | No | Yes |
| Semantic search | No | Yes |
| RAG-powered chat | No | Yes |
| Simulator execution | No | Yes |
| Research creation | No | Yes |
| Depth tree details | No | Yes |

## Wallet Authentication (for agents)

```python
from eth_account import Account
from eth_account.messages import encode_defunct

private_key = "0xYOUR_PRIVATE_KEY"
wallet = Account.from_key(private_key).address

result = sdk.authenticate(
    wallet_address=wallet,
    sign_fn=lambda msg: Account.sign_message(
        encode_defunct(text=msg), private_key
    ).signature.hex(),
)
```

## Documentation

Full API reference and examples at [circle.news/docs](https://circle.news/docs)
