README.md

---
title: yarqa — Plug-Flow Compartments (live or sample, always honest)
emoji: 🌊
colorFrom: gray
colorTo: yellow
sdk: docker
app_port: 7860
short_description: Clean-room CFD compartments — live or sample, always honest
pinned: false
license: apache-2.0
tags:
  - cfd
  - plug-flow
  - simulation
  - receipts
  - honest-by-design
  - szl-holdings
---


<div align="center">
<p>

[![governed](https://img.shields.io/badge/governed-SZL%20Holdings-3af4c8?style=flat-square)](https://huggingface.co/SZLHOLDINGS)
[![Λ](https://img.shields.io/badge/Λ-Conjecture%201%20advisory-d7b96b?style=flat-square)](https://a-11-oy.com)
[![license](https://img.shields.io/badge/license-apache--2.0-7e8aa3?style=flat-square)](https://huggingface.co/spaces/SZLHOLDINGS/yarqa)

</p>
</div>
<!-- SZL-ESTATE-CARD:v2:START -->
<p align="center"><a href="https://a-11-oy.com/"><img src="https://huggingface.co/spaces/SZLHOLDINGS/README/resolve/main/assets/estate-banner-v2.svg" alt="SZL Holdings — governed, receipted, verifiable" width="100%"></a></p>
<p align="center">
  <a href="https://github.com/szl-holdings/.github/tree/main/doctrine"><img src="https://img.shields.io/badge/doctrine-v11%20LOCKED-0B1F3A?style=flat-square" alt="doctrine v11"></a>
  <a href="https://a-11-oy.com/"><img src="https://img.shields.io/badge/evidence%20wall-LIVE%20%C2%B7%20verify%20in%20browser-3AF4C8?style=flat-square" alt="live evidence wall"></a>
  <a href="https://huggingface.co/datasets/SZLHOLDINGS/szl-lake"><img src="https://img.shields.io/badge/szl--lake-offline%20verifiable-C9B787?style=flat-square" alt="szl-lake offline verifiable"></a>
  <a href="https://huggingface.co/spaces/SZLHOLDINGS/holographic"><img src="https://img.shields.io/badge/estate%20map-holographic-5B8DEE?style=flat-square" alt="holographic estate map"></a>
</p>
<p align="center"><sub>Part of the <a href="https://huggingface.co/SZLHOLDINGS">SZL Holdings</a> governed estate — claims are designed to carry checkable receipts. Verification proves integrity &amp; origin, never accuracy or performance.</sub></p>
<!-- SZL-ESTATE-CARD:v2:END -->

# yarqa Space

A multi-tab demo of **yarqa** — clean-room plug-flow compartmentalization for
compartmental CFD models (Apache-2.0). FastAPI backend + a sovereign static app
with **vendored THREE r160** (no CDN; the library is copied into `static/lib/`).

> **Honesty (doctrine v11).** yarqa is an **engineering method (CFD) tier**
> capability. It is **NOT** a locked theorem, is **never** folded into the
> locked-8 `{F1,F4,F7,F11,F12,F18,F19,F22}`, and carries **no "proven" badge**.
> Receipts assert **integrity / reproducibility**, *not correctness*.
> Λ = Conjecture 1, Khipu = Conjecture 2, SLSA L1.

## Tabs (each unique)

1. **Flow Compartments (3D)** — vendored-THREE render of a velocity field
   colored by `yarqa.compartmentalize` labels; `align_threshold` + top-k
   sliders; live recompute; compartment count + signed-ready receipt digest.
2. **Agentic Loop** — live `AgenticYarqa` sense→route→gate→receipt; streams the
   `AgentStep` log (route target, ALLOW/DENY, receipt digest). Conforms to the
   SHAPE of P1/P2/P4 — an engineering loop, not a proof.
3. **Receipt Chain** — the append-only hash-linked chain with a **verify** /
   **tamper** button that replays digests and shows OK / first-broken index.
4. **Forecast** — an HONEST short-horizon projection; everything beyond the
   live/sample data is labeled **PROJECTED**. No invented numbers.
5. **Live Data** — the real feeds powering the maritime/flow use case, each
   independently **LIVE** when reachable else **SAMPLE / SIMULATED**, with the
   source URL cited.

## Architecture rule

Every data tab uses **one code path** with an explicit **LIVE vs SAMPLE** badge
based on **real reachability** of license-clean public feeds — synthetic data is
never shown as LIVE. Same code in the preview sandbox and on the HF Space; only
the badge differs.

### Feeds (license-clean, cited)

| Source | Use | Attribution |
| --- | --- | --- |
| [Open-Meteo Marine](https://marine-api.open-meteo.com/v1/marine?latitude=40.7&longitude=-70.0&hourly=ocean_current_velocity,ocean_current_direction&forecast_days=1) | ocean current velocity/direction | Open-Meteo (CC BY 4.0) |
| [Open-Meteo Wind](https://api.open-meteo.com/v1/forecast?latitude=40.7&longitude=-70.0&hourly=wind_speed_10m,wind_direction_10m&forecast_days=1) | 10 m wind speed/direction | Open-Meteo (CC BY 4.0) |
| [NOAA CO-OPS currents](https://api.tidesandcurrents.noaa.gov/api/prod/datagetter?date=latest&station=cb0102&product=currents&time_zone=gmt&units=metric&format=json) | real-time currents (station cb0102) | NOAA Tides & Currents (U.S. public domain) |

Current speed+direction are converted to 2-D velocity vectors
(`vx = v·sin θ`, `vy = v·cos θ`) sampled over a small lat/lon grid to form a
real velocity field that feeds `yarqa.compartmentalize`.

## Run locally

```bash
pip install -e .                      # the yarqa package (repo root)
pip install -r space/requirements.txt
cd space && python -m uvicorn app:app --port 7860
# open http://localhost:7860
```

## Endpoints

`/healthz` · `/api/feeds` · `/api/compartments` · `/api/agentic` ·
`/api/chain` · `POST /api/chain/verify` · `/api/forecast`

## Provenance

Clean-room. No third-party source copied. THREE.js r160 is vendored verbatim
under its MIT license (`static/lib/three.min.js`). See repo `PROVENANCE.md`.

*SZL Holdings · Apache-2.0 · Doctrine v11.*

---

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19944926.svg)](https://doi.org/10.5281/zenodo.19944926)

## Citation

Part of the **SZL Holdings Ouroboros Thesis** — concept DOI [`10.5281/zenodo.19944926`](https://doi.org/10.5281/zenodo.19944926) (Stephen P. Lutar, Jr., [ORCID 0009-0001-0110-4173](https://orcid.org/0009-0001-0110-4173)). Doctrine v11 LOCKED; Λ = Conjecture 1.

*Signed-off-by: Stephen Lutar <stephenlutar2@gmail.com>*

---

## SZL Estate

Part of the **SZL Holdings** governed-AI estate — *governed AI you can prove*: every decision carries a signed, checkable receipt.

- **Flagship:** [a11oy command console → a-11-oy.com](https://a-11-oy.com)
- **Orgs:** [GitHub · szl-holdings](https://github.com/szl-holdings) · [Hugging Face · SZLHOLDINGS](https://huggingface.co/SZLHOLDINGS)
- **Related Spaces:** [🫀 anatomy](https://huggingface.co/spaces/SZLHOLDINGS/anatomy) · [🛰️ sda](https://huggingface.co/spaces/SZLHOLDINGS/sda) · [◇ holographic](https://huggingface.co/spaces/SZLHOLDINGS/holographic)

**Status:** responding as of 2026-07-09 (HF Space root probe, this session).

<sub>Doctrine v11 · Λ = Conjecture 1 (advisory — never "green"/theorem; open) · honest by design · public data only.</sub>

---

<div align="center">

**[🛡️ SZLHOLDINGS on Hugging Face →](https://huggingface.co/SZLHOLDINGS)**   ·   **[a-11-oy.com →](https://a-11-oy.com)**   ·   **[Estate hub — live →](https://szlholdings-szl-estate-live.static.hf.space)**

### Governed AI you can prove.

<sub>SLSA: L1 honest · L2 attested · L3 roadmap. Λ = Conjecture 1 (advisory, never a theorem). Trust ceiling 0.97 — never 100%. Labels honest by default: MEASURED / REPORTED / MODELED / HEURISTIC / UNKNOWN / UNAVAILABLE. locked-proven = exactly 8 {F1,F4,F7,F11,F12,F18,F19,F22}.</sub>

</div>