wandler67 commited on
Commit
99369ff
·
verified ·
1 Parent(s): a1cf817

feat: add canonical public resource links

Browse files

Promotion of the reviewed Explorer source from GitHub merge ffe580ecca7bbf2788d677ef45e4f52a71cdbc8d, tree 3381da1f115d6bd497e7dc9d243a528bfed19da8. Dataset runtime remains pinned to 1d01f3649ace0301ac3bbe9ee875eea660347a29.

Files changed (3) hide show
  1. README.md +13 -1
  2. app.py +28 -4
  3. src/h2epr_explorer/constants.py +9 -0
README.md CHANGED
@@ -4,9 +4,18 @@ colorFrom: gray
4
  colorTo: blue
5
  sdk: docker
6
  pinned: false
7
- license: cc-by-nc-4.0
8
  ---
9
 
 
 
 
 
 
 
 
 
 
10
  # H²EPR-Bench Explorer
11
 
12
  H²EPR-Bench Explorer is the interactive browsing layer for the Unified-3000
@@ -23,6 +32,9 @@ artifacts. Official benchmark scoring uses expert-adjudicated reference EPGs in
23
  the [manual-gated companion](https://huggingface.co/datasets/AgenticFinLab/H2EPR-Bench-Gold).
24
  The Explorer does not load reference EPGs or frozen evidence packages.
25
 
 
 
 
26
  ## Public data contract
27
 
28
  The Explorer loads five Parquet tables from one immutable dataset revision:
 
4
  colorTo: blue
5
  sdk: docker
6
  pinned: false
7
+ license: apache-2.0
8
  ---
9
 
10
+ [![Website](https://img.shields.io/badge/Website-H2EPR--Bench-0D5159?style=flat-square)](https://agenticfinlab.github.io/H2EPR-Bench/)
11
+ [![Code](https://img.shields.io/badge/Code-GitHub-24292F?style=flat-square)](https://github.com/AgenticFinLab/H2EPR-Bench)
12
+ [![Public Dataset](https://img.shields.io/badge/Dataset-Unified--3000-D99A20?style=flat-square)](https://huggingface.co/datasets/AgenticFinLab/H2EPR-Bench)
13
+ [![Explorer](https://img.shields.io/badge/Explorer-Open-126A70?style=flat-square)](https://huggingface.co/spaces/AgenticFinLab/H2EPR-Bench-Explorer)
14
+ [![FinMycelium](https://img.shields.io/badge/System-FinMycelium-2A7F62?style=flat-square)](https://github.com/AgenticFinLab/FinMycelium)
15
+ [![Gated Gold](https://img.shields.io/badge/Reference_EPGs-Gated_Gold-9A6A16?style=flat-square)](https://huggingface.co/datasets/AgenticFinLab/H2EPR-Bench-Gold)
16
+ [![AgenticFinLab](https://img.shields.io/badge/Lab-AgenticFinLab-51606A?style=flat-square)](https://agenticfinlab.github.io/)
17
+ ![Paper forthcoming](https://img.shields.io/badge/Paper-forthcoming-87939B?style=flat-square)
18
+
19
  # H²EPR-Bench Explorer
20
 
21
  H²EPR-Bench Explorer is the interactive browsing layer for the Unified-3000
 
32
  the [manual-gated companion](https://huggingface.co/datasets/AgenticFinLab/H2EPR-Bench-Gold).
33
  The Explorer does not load reference EPGs or frozen evidence packages.
34
 
35
+ The Explorer source code is Apache-2.0. Dataset content displayed by the app,
36
+ including public Draft EPGs, remains CC BY-NC 4.0 under the Dataset release.
37
+
38
  ## Public data contract
39
 
40
  The Explorer loads five Parquet tables from one immutable dataset revision:
app.py CHANGED
@@ -15,11 +15,16 @@ import streamlit as st
15
  from h2epr_explorer.constants import (
16
  CATALOG_COLUMNS,
17
  DRAFT_UNAVAILABLE_MESSAGE,
 
18
  GOLD_COMPANION_REPO,
 
19
  PROFILE_COLUMNS,
20
  PUBLIC_DATASET_REPO,
21
  PUBLIC_DATASET_REVISION,
 
 
22
  RELEASE_BOUNDARY_NOTICE,
 
23
  )
24
  from h2epr_explorer.data_loader import (
25
  DatasetTransportError,
@@ -158,14 +163,30 @@ with st.sidebar:
158
  width="stretch",
159
  )
160
  st.divider()
 
 
 
 
 
 
 
 
 
 
 
161
  st.link_button(
162
  "Dataset repository",
163
- f"https://huggingface.co/datasets/{PUBLIC_DATASET_REPO}/tree/{PUBLIC_DATASET_REVISION}",
 
 
 
 
 
164
  width="stretch",
165
  )
166
  st.link_button(
167
  "Reference EPG access",
168
- f"https://huggingface.co/datasets/{GOLD_COMPANION_REPO}",
169
  width="stretch",
170
  )
171
 
@@ -302,8 +323,11 @@ with tabs[5]:
302
  f"""
303
  ### Release boundary
304
 
305
- - Public dataset: [`{PUBLIC_DATASET_REPO}`](https://huggingface.co/datasets/{PUBLIC_DATASET_REPO}/tree/{PUBLIC_DATASET_REVISION}) at `{PUBLIC_DATASET_REVISION}`.
306
- - Manual-gated reference EPG companion: [`{GOLD_COMPANION_REPO}`](https://huggingface.co/datasets/{GOLD_COMPANION_REPO}).
 
 
 
307
  - Public Draft EPGs are sanitized FinMycelium construction artifacts, not scoring references.
308
  - Official benchmark scoring uses expert-adjudicated reference EPGs in the gated companion.
309
  - This Explorer loads neither reference EPGs nor frozen evidence packages.
 
15
  from h2epr_explorer.constants import (
16
  CATALOG_COLUMNS,
17
  DRAFT_UNAVAILABLE_MESSAGE,
18
+ FINMYCELIUM_URL,
19
  GOLD_COMPANION_REPO,
20
+ GOLD_COMPANION_URL,
21
  PROFILE_COLUMNS,
22
  PUBLIC_DATASET_REPO,
23
  PUBLIC_DATASET_REVISION,
24
+ PUBLIC_DATASET_REVISION_URL,
25
+ PROJECT_WEBSITE_URL,
26
  RELEASE_BOUNDARY_NOTICE,
27
+ SOURCE_REPOSITORY_URL,
28
  )
29
  from h2epr_explorer.data_loader import (
30
  DatasetTransportError,
 
163
  width="stretch",
164
  )
165
  st.divider()
166
+ st.subheader("Project links")
167
+ st.link_button(
168
+ "Project website",
169
+ PROJECT_WEBSITE_URL,
170
+ width="stretch",
171
+ )
172
+ st.link_button(
173
+ "Source code",
174
+ SOURCE_REPOSITORY_URL,
175
+ width="stretch",
176
+ )
177
  st.link_button(
178
  "Dataset repository",
179
+ PUBLIC_DATASET_REVISION_URL,
180
+ width="stretch",
181
+ )
182
+ st.link_button(
183
+ "FinMycelium system",
184
+ FINMYCELIUM_URL,
185
  width="stretch",
186
  )
187
  st.link_button(
188
  "Reference EPG access",
189
+ GOLD_COMPANION_URL,
190
  width="stretch",
191
  )
192
 
 
323
  f"""
324
  ### Release boundary
325
 
326
+ - Project website: [H²EPR-Bench]({PROJECT_WEBSITE_URL}).
327
+ - Source code: [`AgenticFinLab/H2EPR-Bench`]({SOURCE_REPOSITORY_URL}).
328
+ - Public dataset: [`{PUBLIC_DATASET_REPO}`]({PUBLIC_DATASET_REVISION_URL}) at `{PUBLIC_DATASET_REVISION}`.
329
+ - FinMycelium: [multi-agent event reconstruction system]({FINMYCELIUM_URL}).
330
+ - Manual-gated reference EPG companion: [`{GOLD_COMPANION_REPO}`]({GOLD_COMPANION_URL}).
331
  - Public Draft EPGs are sanitized FinMycelium construction artifacts, not scoring references.
332
  - Official benchmark scoring uses expert-adjudicated reference EPGs in the gated companion.
333
  - This Explorer loads neither reference EPGs nor frozen evidence packages.
src/h2epr_explorer/constants.py CHANGED
@@ -3,8 +3,17 @@ from __future__ import annotations
3
  PUBLIC_DATASET_REPO = "AgenticFinLab/H2EPR-Bench"
4
  GOLD_COMPANION_REPO = "AgenticFinLab/H2EPR-Bench-Gold"
5
 
 
 
 
 
 
 
 
 
6
  DEFAULT_PUBLIC_DATASET_REVISION = "1d01f3649ace0301ac3bbe9ee875eea660347a29"
7
  PUBLIC_DATASET_REVISION = DEFAULT_PUBLIC_DATASET_REVISION
 
8
  LOCAL_DATASET_ENV = "H2EPR_EXPLORER_LOCAL_DATASET_DIR"
9
 
10
  EVENT_ID_PATTERN = r"^H2EPR-[0-9]{4}$"
 
3
  PUBLIC_DATASET_REPO = "AgenticFinLab/H2EPR-Bench"
4
  GOLD_COMPANION_REPO = "AgenticFinLab/H2EPR-Bench-Gold"
5
 
6
+ PROJECT_WEBSITE_URL = "https://agenticfinlab.github.io/H2EPR-Bench/"
7
+ SOURCE_REPOSITORY_URL = "https://github.com/AgenticFinLab/H2EPR-Bench"
8
+ PUBLIC_DATASET_URL = "https://huggingface.co/datasets/AgenticFinLab/H2EPR-Bench"
9
+ EXPLORER_URL = "https://huggingface.co/spaces/AgenticFinLab/H2EPR-Bench-Explorer"
10
+ FINMYCELIUM_URL = "https://github.com/AgenticFinLab/FinMycelium"
11
+ GOLD_COMPANION_URL = "https://huggingface.co/datasets/AgenticFinLab/H2EPR-Bench-Gold"
12
+ AGENTICFINLAB_URL = "https://agenticfinlab.github.io/"
13
+
14
  DEFAULT_PUBLIC_DATASET_REVISION = "1d01f3649ace0301ac3bbe9ee875eea660347a29"
15
  PUBLIC_DATASET_REVISION = DEFAULT_PUBLIC_DATASET_REVISION
16
+ PUBLIC_DATASET_REVISION_URL = f"{PUBLIC_DATASET_URL}/tree/{PUBLIC_DATASET_REVISION}"
17
  LOCAL_DATASET_ENV = "H2EPR_EXPLORER_LOCAL_DATASET_DIR"
18
 
19
  EVENT_ID_PATTERN = r"^H2EPR-[0-9]{4}$"