bpmredacademy commited on
Commit
ecd7286
·
verified ·
1 Parent(s): aa0527a

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +41 -145
README.md CHANGED
@@ -1,168 +1,64 @@
 
1
  ---
2
  license: apache-2.0
3
  library_name: docker
4
  tags:
5
- - finc2e
6
- - humai
7
- - governance
8
- - mlops
9
- - decision-intelligence
10
- - dual-metrics
11
- - docker
12
- - runtime
13
- - might-hub
14
  ---
15
 
16
- # FinC2E Dual-Metrics Runtime (Preview) v1.0.0
17
 
18
- A lightweight, **container-first runtime** for FinC2E that introduces **Dual Metrics** as a foundation for governance-grade AI systems.
19
 
20
- This image is part of the shared **Hugging Face → NVIDIA NGC** release flow and is designed to work alongside **FinC2E-Governance**.
 
 
 
21
 
22
- ---
23
-
24
- ## What is Dual Metrics?
25
-
26
- **Dual Metrics** means measuring two dimensions simultaneously:
27
-
28
- ### 1) Runtime / System Metrics
29
- - Service health
30
- - Startup telemetry
31
- - Adapter pull timing
32
- - Deployment readiness
33
-
34
- ### 2) Decision-System Readiness
35
- - Foundations for audit-friendly execution
36
- - Governance-aligned decision trace hooks
37
- - Separation of runtime logic and private model weights
38
-
39
- This runtime does **not** expose private weights.
40
- It securely pulls them at startup using gated access.
41
-
42
- ---
43
-
44
- ## Hugging Face Repositories
45
-
46
- - **Runtime (this repository):**
47
- `MightHubHumAI/FinC2E_DualMetrics_Runtime`
48
-
49
- - **Adapter (private):**
50
- `MightHubHumAI/FinC2E_Llama33_70B_Adapter`
51
 
52
- - **Model Preview:**
53
- `MightHubHumAI/FinC2E`
54
-
55
- - **Governance Space:**
56
- `FinC2E-Governance` / `HumAI FinC2E HQ`
57
-
58
- ---
59
 
60
- ## Image Tags
61
-
62
- - **Stable (immutable):** `1.0.0`
63
- - **Moving:** `latest`
64
-
65
- For reproducible tests and mirrors (NGC / Brev), use **`1.0.0`**.
66
-
67
- ---
68
-
69
- ## Pull & Run
70
-
71
- ### Pull image
72
- ```bash
73
  docker pull registry.huggingface.co/MightHubHumAI/FinC2E_DualMetrics_Runtime:1.0.0
74
- Run container
75
- docker run --rm \
76
- -e HF_TOKEN=YOUR_HF_TOKEN \
77
- -e ADAPTER_REPO=MightHubHumAI/FinC2E_Llama33_70B_Adapter \
78
- -p 8000:8000 \
79
- registry.huggingface.co/MightHubHumAI/FinC2E_DualMetrics_Runtime:1.0.0
80
-
81
-
82
- HF_TOKEN must have read access to the private adapter repository.
83
-
84
- Endpoints
85
- Health
86
- curl http://localhost:8000/health
87
-
88
-
89
- Example response:
90
-
91
- {"status":"ok","service":"FinC2E Runtime"}
92
-
93
- Dual Metrics
94
- curl http://localhost:8000/metrics
95
 
 
96
 
97
- Example response:
98
-
99
- {
100
- "runtime": "FinC2E_DualMetrics_Runtime",
101
- "adapter_repo": "MightHubHumAI/FinC2E_Llama33_70B_Adapter",
102
- "download_seconds": 4.242,
103
- "timestamp": "2025-09-16T14:30:00Z"
104
- }
105
-
106
- Environment Variables
107
 
 
108
  HF_TOKEN (required)
109
- Hugging Face token with permission to access the private adapter repository.
110
-
111
  ADAPTER_REPO (optional)
112
- Defaults to MightHubHumAI/FinC2E_Llama33_70B_Adapter.
113
-
114
  PORT (optional)
115
- Defaults to 8000.
116
-
117
- Security & IP Model
118
-
119
- Adapter weights are private and never embedded in the image.
120
-
121
- Runtime image is public, auditable, and mirrorable.
122
-
123
- This separation enables:
124
-
125
- controlled access
126
-
127
- governance and audit readiness
128
-
129
- Hugging Face → NVIDIA NGC parity
130
-
131
- Brev and enterprise deployment flows
132
-
133
- Release Notes — v1.0.0
134
-
135
- First public runtime release.
136
 
137
- Secure adapter pull via HF_TOKEN.
 
138
 
139
- /health and /metrics endpoints available.
 
140
 
141
- Immutable 1.0.0 tag + rolling latest.
142
-
143
- HF → NGC → Brev Shared Release Discipline
144
-
145
- Hugging Face tag 1.0.0 == NVIDIA NGC tag 1.0.0.
146
-
147
- No breaking changes under the same tag.
148
-
149
- All future changes increment semver (1.0.1, 1.1.0, 2.0.0).
150
-
151
- This ensures deterministic behavior across registries and deployment platforms.
152
-
153
- Roadmap
154
-
155
- Upcoming iterations include:
156
-
157
- Decision trace endpoints (JSONL, audit-ready).
158
-
159
- Model routing and orchestration hooks (Galaxy container foundations).
160
-
161
- NVIDIA NGC packaging and listing.
162
-
163
- Brev deployment profiles for GPU-backed environments.
164
-
165
- License
166
 
 
167
  Apache-2.0 applies to runtime code and container packaging.
168
- Model adapters and weights are governed separately under a private license.
 
1
+ FinC2E Dual-Metrics Runtime (Preview) — v1.0.0
2
  ---
3
  license: apache-2.0
4
  library_name: docker
5
  tags:
6
+ - finc2e
7
+ - humai
8
+ - governance
9
+ - mlops
10
+ - decision-intelligence
11
+ - dual-metrics
12
+ - docker
13
+ - runtime
14
+ - might-hub
15
  ---
16
 
17
+ A lightweight, container-first runtime for FinC2E that introduces Dual Metrics as a foundation for governance-grade AI systems.
18
 
19
+ This image is part of the shared Hugging Face NVIDIA NGC release flow and is designed to work alongside FinC2E-Governance.
20
 
21
+ WHAT IS DUAL METRICS
22
+ Dual Metrics means measuring two dimensions simultaneously:
23
+ 1) Runtime / System Metrics
24
+ 2) Decision-System Readiness
25
 
26
+ HF REPOSITORIES
27
+ Runtime: MightHubHumAI/FinC2E_DualMetrics_Runtime
28
+ Adapter (private): MightHubHumAI/FinC2E_Llama33_70B_Adapter
29
+ Model preview: MightHubHumAI/FinC2E
30
+ Governance Space: FinC2E-Governance / HumAI FinC2E HQ
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
31
 
32
+ IMAGE TAGS
33
+ Stable: 1.0.0
34
+ Moving: latest
 
 
 
 
35
 
36
+ PULL & RUN
 
 
 
 
 
 
 
 
 
 
 
 
37
  docker pull registry.huggingface.co/MightHubHumAI/FinC2E_DualMetrics_Runtime:1.0.0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
38
 
39
+ docker run --rm -e HF_TOKEN=YOUR_HF_TOKEN -e ADAPTER_REPO=MightHubHumAI/FinC2E_Llama33_70B_Adapter -p 8000:8000 registry.huggingface.co/MightHubHumAI/FinC2E_DualMetrics_Runtime:1.0.0
40
 
41
+ ENDPOINTS
42
+ /health
43
+ /metrics
 
 
 
 
 
 
 
44
 
45
+ ENVIRONMENT VARIABLES
46
  HF_TOKEN (required)
 
 
47
  ADAPTER_REPO (optional)
 
 
48
  PORT (optional)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
49
 
50
+ SECURITY
51
+ Adapter weights remain private and are never embedded in the image.
52
 
53
+ RELEASE NOTES
54
+ v1.0.0 – First public runtime release.
55
 
56
+ ROADMAP
57
+ Decision trace endpoints
58
+ Model routing
59
+ NGC packaging
60
+ Brev deployment
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
61
 
62
+ LICENSE
63
  Apache-2.0 applies to runtime code and container packaging.
64
+