Metadata-Version: 2.5
Name: kairopsis
Version: 0.2.0
Summary: Relative-value idea generation dashboard powered by metapyle
Project-URL: Repository, https://github.com/stabilefrisur/kairopsis
Project-URL: Documentation, https://github.com/stabilefrisur/kairopsis/blob/main/src/kairopsis/docs/human-guide.md
Project-URL: Issues, https://github.com/stabilefrisur/kairopsis/issues
Author-email: Stabile Frisur <26568863+stabilefrisur@users.noreply.github.com>
Requires-Python: >=3.12
Requires-Dist: fastapi==0.135.2
Requires-Dist: jinja2==3.1.6
Requires-Dist: metapyle>=0.1.6
Requires-Dist: pandas==3.0.6
Requires-Dist: platformdirs==4.5.1
Requires-Dist: pydantic==2.13.5
Requires-Dist: tzdata==2026.4
Requires-Dist: uvicorn==0.42.0
Description-Content-Type: text/markdown

# Kairopsis

A local workspace for relative-value research.

Explore market series, compare relationships, and develop investment Ideas with
charts and notes you can revisit. Kairopsis brings investigation and saved
evidence together in a browser-based dashboard.

- **Investigate:** levels, differences, ratios and regression residuals, with
  explicit reference periods and optional risk adjustment. Library and Analyses
  open the same editor, with automatic previews and explicit Save/Discard.
- **Explore:** combine Library series and local calculations in several charts,
  reuse loaded data, and choose each chart's dates and observations.
- **Retain evidence:** save charts, observations and notes alongside each Idea.
- **Screen and brief:** retain dated screening results for an agent to review
  against the recorded economic rationale and turn into a concise brief.
- **Revisit and share:** compare saved evidence with the latest data and export
  charts or spreadsheet-ready values.

A built-in demo lets you explore without market-data credentials. Your research
stays in a local workspace. Live data access uses Metapyle.

For repeatable development tests, the [persisted CSV demo dataset](tests/fixtures/demo/README.md)
provides 74 synthetic series, including six credit assets with multiple fields,
and a standard Metapyle `localfile` catalogue.

## Guides

- [Human guide](https://github.com/stabilefrisur/kairopsis/blob/main/src/kairopsis/docs/human-guide.md)
  — everyday investigation, Ideas and exports.
- [Explore guide](https://github.com/stabilefrisur/kairopsis/blob/main/src/kairopsis/docs/explore.md)
  — collections, chart dates, cached data and frozen evidence.
- [Agent setup guide](https://github.com/stabilefrisur/kairopsis/blob/main/src/kairopsis/docs/agent-setup.md)
  — Copilot runbook for an upstream source workspace, data connections and handoff.
- [Analysis configuration skill](https://github.com/stabilefrisur/kairopsis/blob/main/src/kairopsis/skills/kairopsis-analysis/SKILL.md)
  — agent guidance for economic questions, data shaping and analytical settings,
  with a complete combination map and worked examples.
- [Screening skill](https://github.com/stabilefrisur/kairopsis/blob/main/src/kairopsis/skills/kairopsis-screening/SKILL.md)
  — run a screening or review retained results, investigate significant themes,
  and save a brief with traceable evidence.

All three guides and both self-contained skills are included in the installed
Python package and the source archive.
Requires Python 3.12 or later. Frontend assets are bundled; no Node.js setup is
needed.
