Add organization card

README.md

@@ -1,10 +1,83 @@
 ---
 title: README
-emoji: 🚀
-colorFrom: pink
-colorTo: purple
+emoji: 📉
+colorFrom: indigo
+colorTo: gray
 sdk: static
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+<div class="grid lg:grid-cols-3 gap-x-4 gap-y-7">
+
+<p class="lg:col-span-3">
+<strong>Pre-built searchable indexes of financial and economic data series for <a href="https://github.com/ockham-sh/parsimony" class="underline">parsimony</a>.</strong><br/>
+Each dataset here is a drop-in catalog — a parquet of series metadata plus a FAISS embedding index — that lets parsimony connectors resolve a natural-language query (<em>"Swiss policy rate"</em>, <em>"US 10-year yield"</em>) to a provider-native series ID in milliseconds, without hitting the upstream provider.
+</p>
+
+<a href="https://github.com/ockham-sh/parsimony" class="block overflow-hidden group">
+  <div class="w-full h-40 object-cover mb-2 rounded-lg flex items-center justify-center bg-gray-50 border border-gray-200">
+    <pre class="text-xs text-gray-800 whitespace-pre-wrap px-4">pip install parsimony \
+  parsimony-sdmx \
+  parsimony-fred</pre>
+  </div>
+  <div class="underline">parsimony on GitHub</div>
+</a>
+
+<a href="https://docs.parsimony.dev" class="block overflow-hidden group">
+  <div class="w-full h-40 object-cover mb-2 rounded-lg flex items-center justify-center bg-gray-50 border border-gray-200">
+    <span class="text-sm text-gray-700">docs.parsimony.dev</span>
+  </div>
+  <div class="underline">Documentation</div>
+</a>
+
+<a href="https://pypi.org/project/parsimony-core/" class="block overflow-hidden group">
+  <div class="w-full h-40 object-cover mb-2 rounded-lg flex items-center justify-center bg-gray-50 border border-gray-200">
+    <span class="text-sm text-gray-700">parsimony-core on PyPI</span>
+  </div>
+  <div class="underline">PyPI</div>
+</a>
+
+<div class="lg:col-span-3">
+<h3>What's in each catalog</h3>
+<ul>
+  <li><code>entries.parquet</code> — one row per data series with provider ID, title, units, frequency, and provider-specific attributes.</li>
+  <li><code>embeddings.faiss</code> — dense vector index over series titles and descriptions for semantic lookup.</li>
+  <li><code>meta.json</code> — provider, snapshot timestamp, embedding model, and row counts.</li>
+</ul>
+<p>Catalogs are pulled on-demand by the matching connector (e.g. <code>parsimony-sdmx</code> reads every central-bank catalog below) and cached locally. No API keys required to read the indexes — keys are only needed when you fetch actual series data from the upstream provider.</p>
+</div>
+
+<div class="lg:col-span-3">
+<h3>Available catalogs</h3>
+<table>
+  <thead><tr><th>Dataset</th><th>Provider</th><th>Protocol</th></tr></thead>
+  <tbody>
+    <tr><td><a href="https://huggingface.co/datasets/parsimony-dev/treasury">treasury</a></td><td>U.S. Department of the Treasury</td><td>Fiscal Data API</td></tr>
+    <tr><td><a href="https://huggingface.co/datasets/parsimony-dev/snb">snb</a></td><td>Swiss National Bank</td><td>SDMX</td></tr>
+    <tr><td><a href="https://huggingface.co/datasets/parsimony-dev/riksbank">riksbank</a></td><td>Sveriges Riksbank</td><td>SDMX</td></tr>
+    <tr><td><a href="https://huggingface.co/datasets/parsimony-dev/boc">boc</a></td><td>Bank of Canada</td><td>SDMX</td></tr>
+    <tr><td><a href="https://huggingface.co/datasets/parsimony-dev/rba">rba</a></td><td>Reserve Bank of Australia</td><td>SDMX</td></tr>
+    <tr><td><a href="https://huggingface.co/datasets/parsimony-dev/bde">bde</a></td><td>Banco de España</td><td>SDMX</td></tr>
+  </tbody>
+</table>
+<p>More providers land as their connectors graduate. The publishing pipeline is open — see <a href="https://github.com/ockham-sh/parsimony-connectors">parsimony-connectors</a> for how catalogs are generated and contributed.</p>
+</div>
+
+<div class="lg:col-span-3">
+<h3>Quick start</h3>
+<pre class="text-xs"><code>from parsimony import Parsimony
+
+p = Parsimony()
+# Resolves "swiss policy rate" against the snb catalog, then fetches from SNB.
+series = p.find("swiss policy rate").fetch()
+print(series.tail())
+</code></pre>
+</div>
+
+<div class="lg:col-span-3">
+<p class="text-sm text-gray-600">
+Maintained by <a href="https://github.com/ockham-sh">Ockham</a>. Issues and contributions: <a href="https://github.com/ockham-sh/parsimony-connectors">parsimony-connectors</a>.
+</p>
+</div>
+
+</div>