Metadata-Version: 2.4
Name: seiche
Version: 0.11.0
Summary: Funding-stress and leveraged-positioning research terminal with public, credentialed-official, licensed, and fail-closed market-data boundaries.
Project-URL: Homepage, https://seiche.info
Project-URL: Documentation, https://seiche.info/developers
Project-URL: Source, https://github.com/beepboop2025/seiche
Project-URL: Issues, https://github.com/beepboop2025/seiche/issues
Project-URL: Changelog, https://github.com/beepboop2025/seiche/blob/main/CHANGELOG.md
Project-URL: MCP server, https://api.seiche.info/mcp
Author-email: Mrinal <beepboop2025@users.noreply.github.com>
Maintainer-email: Seiche maintainers <beepboop2025@users.noreply.github.com>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
Keywords: capital-markets,financial-data,funding-liquidity,mcp,model-context-protocol,money-markets,open-data,research
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.12
Requires-Dist: arch>=7
Requires-Dist: cryptography>=42
Requires-Dist: fastapi>=0.115
Requires-Dist: holidays>=0.76
Requires-Dist: httpx>=0.27
Requires-Dist: numpy>=1.26
Requires-Dist: pandas>=2.2
Requires-Dist: scikit-learn>=1.4
Requires-Dist: scipy>=1.11
Requires-Dist: tzdata>=2025.2
Requires-Dist: uvicorn>=0.30
Provides-Extra: collectors
Requires-Dist: openpyxl>=3.1; extra == 'collectors'
Requires-Dist: pyarrow>=16; extra == 'collectors'
Provides-Extra: deploy-test
Requires-Dist: httpx2>=2.0.0; extra == 'deploy-test'
Requires-Dist: pytest-asyncio>=0.23; extra == 'deploy-test'
Requires-Dist: pytest>=8; extra == 'deploy-test'
Provides-Extra: dev
Requires-Dist: httpx2>=2.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-memray>=1.7; (sys_platform != 'win32') and extra == 'dev'
Requires-Dist: pytest-pystack>=1.0; (sys_platform == 'linux') and extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Provides-Extra: notary
Requires-Dist: opentimestamps>=0.4; extra == 'notary'
Provides-Extra: postgres
Requires-Dist: psycopg[binary]>=3.2; extra == 'postgres'
Description-Content-Type: text/markdown

# Seiche

[![PyPI](https://img.shields.io/pypi/v/seiche)](https://pypi.org/project/seiche/)
[![Python](https://img.shields.io/pypi/pyversions/seiche)](https://pypi.org/project/seiche/)
[![MCP Registry](https://img.shields.io/badge/MCP-registry-6f42c1)](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.beepboop2025%2Fseiche)
[![AGPL-3.0-or-later](https://img.shields.io/badge/code-AGPL--3.0--or--later-blue)](https://github.com/beepboop2025/seiche/blob/main/LICENSE)

Seiche is an open-source money-, foreign-exchange, and capital-market evidence
terminal, with its deepest live coverage in US-dollar funding. It joins public
and official sources from the Federal Reserve, New York Fed, OFR, US Treasury,
CFTC, and other authorities into a source-clocked research surface.

Every output keeps its as-of date, provenance, evidence status, known gaps, and
point-in-time eligibility attached. Seiche is a research and evidence tool—not
a real-time quote service, execution venue, or investment adviser.

- Live terminal: [seiche.info](https://seiche.info)
- Developer guide and tool runner: [seiche.info/developers](https://seiche.info/developers)
- Source and full documentation: [github.com/beepboop2025/seiche](https://github.com/beepboop2025/seiche)
- Hosted MCP server: `https://api.seiche.info/mcp`

## Install and run

Seiche requires Python 3.12 or newer.

```bash
python3.12 -m venv .venv
.venv/bin/pip install seiche
.venv/bin/seiche pull
.venv/bin/seiche brief
```

Start the local REST API and terminal UI with:

```bash
.venv/bin/seiche serve
```

The first pull can be slower while the local cadence-aware cache is populated.
Subsequent reads reuse that cache and continue to expose stale or unavailable
inputs explicitly instead of silently dropping them.

## Use Seiche from an AI agent

Seiche is a [Model Context Protocol](https://modelcontextprotocol.io) server.
Run it locally over stdio:

```bash
SEICHE_MCP_PUBLIC=1 .venv/bin/seiche-mcp
```

Or connect an MCP-capable client directly to the public Streamable HTTP server:

```text
https://api.seiche.info/mcp
```

Eleven evidence/context tools are anonymous: the current funding-stress read,
historical analogs, public backtest, data health, crypto record, institutional
flows, oil/funding, FX/materials, US money markets, world markets, and the latest
article. Five higher-cost forecast, replay, positioning, prose, and LLM tools
require an account and are omitted from anonymous `tools/list` responses.

The canonical registry identifier is:

```text
io.github.beepboop2025/seiche
```

See the [MCP integration guide](https://github.com/beepboop2025/seiche/blob/main/docs/MCP.md)
for Claude, Codex, Cursor, VS Code, and raw JSON-RPC examples.

## Data and licensing boundary

The source code is licensed under AGPL-3.0-or-later. Upstream data keeps its own
terms: Seiche's software license does not grant redistribution rights over data
from third parties. Public outputs distinguish redistributable observations,
bounded derived context, metadata-only sources, restricted inputs, and declared
gaps. Review the source citation and rights fields before republishing data.

For research citation, use the repository's `CITATION.cff`; for defects or data
questions, open a [GitHub issue](https://github.com/beepboop2025/seiche/issues).
