Text Generation
PEFT
Safetensors
English
qwen2
qlora
governed-agent
proposal-only
research-only
szl-holdings
khipu
abstain-retrain
conversational
Instructions to use SZLHOLDINGS/KHIPU-R2 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use SZLHOLDINGS/KHIPU-R2 with PEFT:
from peft import PeftModel from transformers import AutoModelForCausalLM base_model = AutoModelForCausalLM.from_pretrained("unsloth/Qwen2.5-1.5B-Instruct-bnb-4bit") model = PeftModel.from_pretrained(base_model, "SZLHOLDINGS/KHIPU-R2") - Notebooks
- Google Colab
- Kaggle
card: complete investor-grade card (generated, links verified)
Browse files
README.md
CHANGED
|
@@ -1,169 +1,44 @@
|
|
| 1 |
---
|
| 2 |
-
thumbnail: https://huggingface.co/SZLHOLDINGS/KHIPU-R2/resolve/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/og-card.png
|
| 3 |
license: apache-2.0
|
| 4 |
-
|
| 5 |
-
- en
|
| 6 |
-
base_model: Qwen/Qwen2.5-1.5B-Instruct
|
| 7 |
-
base_model_relation: adapter
|
| 8 |
-
library_name: peft
|
| 9 |
-
pipeline_tag: text-generation
|
| 10 |
tags:
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
- governed-agent
|
| 14 |
-
- proposal-only
|
| 15 |
-
- research-only
|
| 16 |
-
- szl-holdings
|
| 17 |
-
- khipu
|
| 18 |
-
- abstain-retrain
|
| 19 |
-
szl:
|
| 20 |
-
doctrine: v11-LOCKED
|
| 21 |
-
lean: "749/14/163"
|
| 22 |
-
lambda: "Conjecture 1 — advisory, never a theorem"
|
| 23 |
-
artifact_class: ADAPTER
|
| 24 |
-
publication_eligible: false
|
| 25 |
-
autonomy_eligible: false
|
| 26 |
-
never_overwrite: SZLHOLDINGS/SZL-Khipu-1.5B
|
| 27 |
-
jobs: COMPLETED
|
| 28 |
-
job_id: "6a91bf11984507d9db4ea104"
|
| 29 |
-
job_prior_error: "6a91ba2c45686a1580c12020"
|
| 30 |
-
weights: AVAILABLE
|
| 31 |
-
evals: MEASURED
|
| 32 |
-
gpu: UNAVAILABLE
|
| 33 |
---
|
| 34 |
|
| 35 |
-
|
| 36 |
-
<p><a href="https://huggingface.co/SZLHOLDINGS"><img src="https://raw.githubusercontent.com/szl-holdings/szl-brand/27d12e77fc0f9f1a0e5fae8b34adf2380d51d070/kit/logos/orbit-v2/suite/szl-icon-32.svg" alt="SZL Holdings" width="48" height="48" /></a></p>
|
| 37 |
|
| 38 |
-
|
| 39 |
|
| 40 |
-
|
|
|
|
|
|
|
| 41 |
|
| 42 |
-
**Artifact:** QLoRA adapter; separate merged checkpoint · **Stage:** Research · release blocked
|
| 43 |
|
| 44 |
-
|
| 45 |
|
| 46 |
-
|
| 47 |
|
| 48 |
-
##
|
| 49 |
|
| 50 |
-
-
|
| 51 |
-
-
|
| 52 |
-
-
|
| 53 |
|
| 54 |
-
<details>
|
| 55 |
-
<summary>Technical details and evidence</summary>
|
| 56 |
|
| 57 |
-
|
| 58 |
-
<!-- szl:artifact-identity-reconciled -->
|
| 59 |
-
> **Artifact identity (noted 2026-09-30).** Besides the LoRA adapter, this repository's root carries a merged full-precision checkpoint (`model.safetensors` + `config.json`, loadable with `transformers`) produced by the receipted CPU merge of this adapter into its declared base (`merge_receipt.json`). The adapter remains the artifact of record for every figure on this card; the merged bytes carry no separate held-out receipt and add no claim. Metadata-only note.
|
| 60 |
|
| 61 |
-
|
| 62 |
|
| 63 |
-
|
| 64 |
|
| 65 |
-
|
| 66 |
-
|
| 67 |
-
|
| 68 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 69 |
|
| 70 |
-
|
| 71 |
-
No weights were downloaded, no model was loaded, and no evaluation or
|
| 72 |
-
signature verification was rerun in this review.
|
| 73 |
-
|
| 74 |
-
## Distributed forms
|
| 75 |
-
|
| 76 |
-
| Form | Files | Scope |
|
| 77 |
-
|---|---|---|
|
| 78 |
-
| QLoRA adapter | `adapter_model.safetensors`, `adapter_config.json` | The PEFT example below explicitly selects this adapter form. |
|
| 79 |
-
| Separate fp32 merged checkpoint | Root `model.safetensors`, `config.json`, `merge_receipt.json` | A distinct runtime form; selecting the adapter does not load this merged checkpoint. |
|
| 80 |
-
|
| 81 |
-
Current artifact bytes and their equality to historical evaluated bytes
|
| 82 |
-
were not independently rehashed. The merge receipt's base revision is
|
| 83 |
-
`main@merge-time`, which is not an immutable base identity.
|
| 84 |
-
|
| 85 |
-
## Dated evaluation records
|
| 86 |
-
|
| 87 |
-
The [2026-08-28 owner-run job record](https://huggingface.co/SZLHOLDINGS/KHIPU-R2/blob/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/eval_measured.json)
|
| 88 |
-
reports in-process Unsloth generation at temperature 0 with scoring ported
|
| 89 |
-
from `eval_khipu.py`. It reports `held_out_in_gradients: false`.
|
| 90 |
-
|
| 91 |
-
| Metric | Historical result | Limit |
|
| 92 |
-
|---|---|---|
|
| 93 |
-
| plan-valid | **11 / 11** | Small owner-run synthetic protocol |
|
| 94 |
-
| grounding (`eval.jsonl` navigate) | **5 / 5** | Five navigation cases |
|
| 95 |
-
| abstain (`adversarial.jsonl`) | **3 / 6** | Visible release blocker; not a pass |
|
| 96 |
-
| hallucinated citations | **0** | These cases only |
|
| 97 |
-
|
| 98 |
-
The [2026-09-13 corrected-harness CPU re-verification](https://huggingface.co/SZLHOLDINGS/KHIPU-R2/blob/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/eval_verified_2026-09-13.json)
|
| 99 |
-
reports **11/11 plan-valid, 5/5 grounding, and 3/6 abstention** on rebuilt
|
| 100 |
-
fp16 merges and the published fp32 merge. The owner fixed a decoding
|
| 101 |
-
harness that returned prompt characters instead of generated output;
|
| 102 |
-
**all prior fp16 scores produced by that buggy harness are void**.
|
| 103 |
-
The corrected runs are separate owner records and do not promote the model.
|
| 104 |
-
|
| 105 |
-
No signed R2 eval receipt in this atelier. The linked owner-run records
|
| 106 |
-
are not an independent evaluation or public leaderboard. GPU **UNAVAILABLE**
|
| 107 |
-
describes the CPU-only re-verification record and the earlier card state;
|
| 108 |
-
no current hardware availability was tested. Publication and autonomy
|
| 109 |
-
eligibility remain **false**.
|
| 110 |
-
|
| 111 |
-
The original Khipu **2/6** abstention record and R2's **3/6** record remain
|
| 112 |
-
separate. No broad quality score or general safety guarantee follows.
|
| 113 |
-
|
| 114 |
-
## Historical training
|
| 115 |
-
|
| 116 |
-
The prior card and [training receipt](https://huggingface.co/SZLHOLDINGS/KHIPU-R2/blob/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/training_receipt.json)
|
| 117 |
-
describe QLoRA r=32, α=64, seed 11, learning rate 2e-4 and 45 epochs,
|
| 118 |
-
on 15 navigation rows plus 8 abstention rows oversampled four times.
|
| 119 |
-
The reported train loss **0.017188…** is a training metric, not evaluation.
|
| 120 |
-
The historical adapter digest is
|
| 121 |
-
`e44d53f29f2d443598e06d6c0441557fd3a5010888c7aa97b56ec3c0e050d349`;
|
| 122 |
-
it was not recomputed here. The earlier card records successful job
|
| 123 |
-
`6a91bf11984507d9db4ea104` and prior error `6a91ba2c45686a1580c12020`
|
| 124 |
-
(Trackio 404). This review did not query those jobs or rerun training.
|
| 125 |
-
|
| 126 |
-
## Adapter usage
|
| 127 |
-
|
| 128 |
-
This example is **untested in this review**. An owner-verified immutable
|
| 129 |
-
base revision is required; none is invented here. The blank base revision
|
| 130 |
-
fails before imports or remote loading. The adapter repository is pinned
|
| 131 |
-
to the reviewed documentation and metadata snapshot; this is not an
|
| 132 |
-
evaluation binding or release approval.
|
| 133 |
-
|
| 134 |
-
```python
|
| 135 |
-
import re
|
| 136 |
-
|
| 137 |
-
BASE_REVISION = "" # Supply an owner-verified immutable base commit.
|
| 138 |
-
if not re.fullmatch(r"[0-9a-f]{40}", BASE_REVISION):
|
| 139 |
-
raise ValueError("An owner-verified immutable base revision is required")
|
| 140 |
-
|
| 141 |
-
from peft import PeftModel
|
| 142 |
-
from transformers import AutoModelForCausalLM, AutoTokenizer
|
| 143 |
-
|
| 144 |
-
base_id = "Qwen/Qwen2.5-1.5B-Instruct"
|
| 145 |
-
adapter_id = "SZLHOLDINGS/KHIPU-R2"
|
| 146 |
-
adapter_revision = "9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52"
|
| 147 |
-
tok = AutoTokenizer.from_pretrained(base_id, revision=BASE_REVISION)
|
| 148 |
-
base = AutoModelForCausalLM.from_pretrained(base_id, revision=BASE_REVISION)
|
| 149 |
-
model = PeftModel.from_pretrained(base, adapter_id, revision=adapter_revision)
|
| 150 |
-
```
|
| 151 |
-
|
| 152 |
-
Outputs are proposals requiring external validation and approval. Lab load
|
| 153 |
-
remains forbidden. [A11OY-MINI](https://huggingface.co/SZLHOLDINGS/A11OY-MINI)
|
| 154 |
-
contains separately scoped legacy and R2 evidence and inherits no KHIPU-R2
|
| 155 |
-
score or qualification.
|
| 156 |
-
|
| 157 |
-
Apache-2.0 is declared in metadata. No standalone `LICENSE` is listed at
|
| 158 |
-
the reviewed revision; artifact license coverage was not independently
|
| 159 |
-
verified. A license addition requires source-owner review of that coverage.
|
| 160 |
-
|
| 161 |
-
Canonical card authoring source: [khipu-r2/card/README.md](https://github.com/szl-holdings/szl-forge/blob/6f4ac90ff503265cec9c0436587f086e52d6124e/khipu-r2/card/README.md).
|
| 162 |
-
Doctrine v11 LOCKED 749/14/163. Λ = Conjecture 1, advisory, never a theorem.
|
| 163 |
-
|
| 164 |
-
<!-- SZL-CARD-TECHNICAL:v1:END -->
|
| 165 |
-
</details>
|
| 166 |
-
|
| 167 |
-
<!-- SZL-NATIVE-ARTWORK:v1 -->
|
| 168 |
-
SZL Orbit artwork: [source](https://github.com/szl-holdings/szl-brand/blob/27d12e77fc0f9f1a0e5fae8b34adf2380d51d070/kit/logos/orbit-v2/suite/szl-icon-32.svg) · [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Software and artifact licensing remain declared above.
|
| 169 |
-
<!-- /SZL-NATIVE-ARTWORK:v1 -->
|
|
|
|
| 1 |
---
|
|
|
|
| 2 |
license: apache-2.0
|
| 3 |
+
library_name: transformers
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
tags:
|
| 5 |
+
- szl-holdings
|
| 6 |
+
- receipts-backed
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 7 |
---
|
| 8 |
|
| 9 |
+
# Khipu R2
|
|
|
|
| 10 |
|
| 11 |
+
> Khipu R2 — part of the SZL Holdings AI estate
|
| 12 |
|
| 13 |
+
[](https://github.com/szl-holdings)
|
| 14 |
+
[](https://huggingface.co/datasets/SZLHOLDINGS/frontier-54-runs)
|
| 15 |
+
[](https://github.com/szl-holdings)
|
| 16 |
|
|
|
|
| 17 |
|
| 18 |
+
## What this is
|
| 19 |
|
| 20 |
+
This model is part of the SZL Holdings estate: an AI research and product portfolio where every claim carries a receipt. Measured results for this artifact live on the public receipts chain — we publish numbers only where a signed receipt backs them.
|
| 21 |
|
| 22 |
+
## Provenance
|
| 23 |
|
| 24 |
+
- **Source:** [szl-holdings on GitHub](https://github.com/szl-holdings)
|
| 25 |
+
- **Receipts chain:** [SZLHOLDINGS/frontier-54-runs](https://huggingface.co/datasets/SZLHOLDINGS/frontier-54-runs) — every claim on this card traces to a hash-chained receipt
|
| 26 |
+
- **License:** Apache-2.0
|
| 27 |
|
|
|
|
|
|
|
| 28 |
|
| 29 |
+
## Why it matters (for investors)
|
|
|
|
|
|
|
| 30 |
|
| 31 |
+
SZL Holdings builds receipt-backed AI: measured honesty, a machine-checked constitution, and a public hash-chained evidence chain. This artifact is one piece of that estate.
|
| 32 |
|
| 33 |
+
## The estate
|
| 34 |
|
| 35 |
+
| Surface | Link |
|
| 36 |
+
|---|---|
|
| 37 |
+
| Company | [szlholdings.com](https://szlholdings.com) |
|
| 38 |
+
| Sponsors | [Become a sponsor](https://szlholdings.com/sponsors.html) |
|
| 39 |
+
| Live dashboard | [SI command center](https://szlholdings-si.hf.space) |
|
| 40 |
+
| Living anatomy | [Anatomy](https://szlholdings-anatomy.hf.space) |
|
| 41 |
+
| Autonomy ladder | [The 0.3% partition](https://github.com/szl-holdings/szl-gpu-bridge/blob/main/docs/AUTONOMY_LADDER.md) |
|
| 42 |
+
| Training curriculum | [Ouroboros](https://github.com/szl-holdings/szl-gpu-bridge/blob/main/docs/OUROBOROS_CURRICULUM.md) |
|
| 43 |
|
| 44 |
+
*This card is generated by [tools/hf_cards](https://github.com/szl-holdings/szl-gpu-bridge/tree/main/tools/hf_cards) — links verified at build time.*
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|