Metadata-Version: 2.4
Name: eugene-intelligence
Version: 0.1.1
Summary: Data Infrastructure for AI Agents — SEC, FRED, FMP
Home-page: https://github.com/Matthew-Anyiam/eugene-data-labs
Author: Matthew Anyiam
Author-email: Matthew Anyiam <matthew@eugeneintelligence.com>
License: MIT
Project-URL: Homepage, https://github.com/Matthew-Anyiam/eugene-data-labs
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: feedparser>=6.0.0
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Eugene Intelligence

[![PyPI version](https://badge.fury.io/py/eugene-intelligence.svg)](https://pypi.org/project/eugene-intelligence/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Data Infrastructure for AI Agents**

> Install: `pip install eugene-intelligence`  
> Import: `import eugene`

---

## Quick Start
```python
from eugene.tools.institutional import company

# Stock quote
result = company("AAPL", "prices")
print(result["data"]["price"]["formatted"])  # $270.58

# SEC financials with full provenance
result = company("AAPL", "financials")
print(result["data"]["revenue"]["formatted"])  # $416.16B
print(result["data"]["revenue"]["sec_concept"])  # RevenueFromContractWithCustomerExcludingAssessedTax
print(result["data"]["revenue"]["accession_number"])  # 0000320193-25-000079
```

---

## MCP Server (Claude Desktop)

After `pip install eugene-intelligence`:
```json
{
  "mcpServers": {
    "eugene": {
      "command": "python",
      "args": ["-m", "eugene.mcp_server"]
    }
  }
}
```

**4 Tools:**
| Tool | Description | Types |
|------|-------------|-------|
| `company` | Company data | prices, profile, financials, health, earnings, insider |
| `economy_data` | Economic indicators | inflation, employment, gdp, housing, treasury, forex |
| `regulatory_data` | Government & regulatory | sec_press, fed_speeches, fomc, treasury_debt |
| `research_report` | AI-powered analysis | equity, credit |

---

## Data Sources

| Source | Data |
|--------|------|
| **SEC XBRL** | Financial statements (10-K, 10-Q) with accession numbers |
| **SEC EDGAR** | Insider trades (Form 4), 13F holdings |
| **FRED** | 400K+ economic series |
| **FMP** | Real-time stock prices |
| **Fed RSS** | Speeches, FOMC statements |
| **Treasury** | National debt, yields |

---

## Environment Variables
```bash
# Required for SEC API
export SEC_USER_AGENT="YourApp/1.0 (contact: you@example.com)"

# Optional
export FRED_API_KEY=your_key
export FMP_API_KEY=your_key
```

---

## Compliance & Fair Access

- Requires `SEC_USER_AGENT` with contact info (per SEC policy)
- Default rate limit: 6 requests/second
- Uses CIK and companyfacts caching to reduce load

---

## Demo

Try it: [huggingface.co/spaces/Rex165/eugene-intelligence](https://huggingface.co/spaces/Rex165/eugene-intelligence)

---

## Why Eugene?

Every number traced to source. No hallucination.
```json
{
  "revenue": {
    "value": 416161000000,
    "formatted": "$416.16B",
    "period_end": "2025-09-27",
    "filed_date": "2025-10-31",
    "sec_concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
    "accession_number": "0000320193-25-000079"
  }
}
```

---

*Built for agents that need to get finance right.*
