Instructions to use SZLHOLDINGS/forge-v3 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use SZLHOLDINGS/forge-v3 with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("image-text-to-text", model="SZLHOLDINGS/forge-v3")
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
pipe(text=messages)

# pip install -U transformers accelerate
# Load model directly
from transformers import AutoProcessor, AutoModelForMultimodalLM

processor = AutoProcessor.from_pretrained("SZLHOLDINGS/forge-v3")
model = AutoModelForMultimodalLM.from_pretrained("SZLHOLDINGS/forge-v3", device_map="auto")
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
inputs = processor.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=256)
print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

Notebooks
Google Colab
Kaggle
Local Apps Settings

vLLM

How to use SZLHOLDINGS/forge-v3 with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "SZLHOLDINGS/forge-v3"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "SZLHOLDINGS/forge-v3",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Use Docker

docker model run hf.co/SZLHOLDINGS/forge-v3

SGLang

How to use SZLHOLDINGS/forge-v3 with SGLang:

Install from pip and serve model

# Install SGLang from pip:
pip install sglang
# Start the SGLang server:
python3 -m sglang.launch_server \
    --model-path "SZLHOLDINGS/forge-v3" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "SZLHOLDINGS/forge-v3",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Use Docker images

docker run --gpus all \
    --shm-size 32g \
    -p 30000:30000 \
    -v ~/.cache/huggingface:/root/.cache/huggingface \
    --env "HF_TOKEN=<secret>" \
    --ipc=host \
    lmsysorg/sglang:latest \
    python3 -m sglang.launch_server \
        --model-path "SZLHOLDINGS/forge-v3" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "SZLHOLDINGS/forge-v3",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Docker Model Runner
How to use SZLHOLDINGS/forge-v3 with Docker Model Runner:
```
docker model run hf.co/SZLHOLDINGS/forge-v3
```

betterwithage commited on about 14 hours ago

Commit

b58a04e

verified ·

1 Parent(s): 791bad4

restore: recover the pre-batch README from git history; verified-links section appended

Browse files

Files changed (1) hide show

README.md +33 -19

README.md CHANGED Viewed

@@ -3,32 +3,49 @@ license: apache-2.0
 library_name: transformers
 tags:
 - szl-holdings
-- receipts-backed
 ---
-# Forge V3
-> Forge V3 — part of the SZL Holdings AI estate
-[![License](https://img.shields.io/badge/license-Apache--2.0-22d3ee.svg)](https://github.com/szl-holdings)
-[![Receipts](https://img.shields.io/badge/receipts-on__chain-34d399.svg)](https://huggingface.co/datasets/SZLHOLDINGS/frontier-54-runs)
-[![Source](https://img.shields.io/badge/source-GitHub-64748b.svg)](https://github.com/szl-holdings)
-## What this is
-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.
-## Provenance
-- **Source:** [szl-holdings on GitHub](https://github.com/szl-holdings)
-- **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
-- **License:** Apache-2.0
-## Why it matters (for investors)
-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.
 ## The estate
@@ -36,9 +53,6 @@ SZL Holdings builds receipt-backed AI: measured honesty, a machine-checked const
 |---|---|
 | Company | [szlholdings.com](https://szlholdings.com) |
 | Sponsors | [Become a sponsor](https://szlholdings.com/sponsors.html) |
 | Live dashboard | [SI command center](https://szlholdings-szlholdings-si.hf.space) |
-| Living anatomy | [Anatomy](https://szlholdings-anatomy.hf.space) |
-| Autonomy ladder | [The 0.3% partition](https://github.com/szl-holdings/szl-gpu-bridge/blob/main/docs/AUTONOMY_LADDER.md) |
-| Training curriculum | [Ouroboros](https://github.com/szl-holdings/szl-gpu-bridge/blob/main/docs/OUROBOROS_CURRICULUM.md) |
-*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.*

 library_name: transformers
 tags:
 - szl-holdings
+- doctrine-v11
+- launch-contract-governed
+- research-candidate
+base_model: SZLHOLDINGS/szl-receiptagent-qwen35-0.8b-sft-v3
+base_model_revision: 0340c300052e248367a3407aa493ef72a0da79fe
 ---
+<div align="center">
+<img src="https://huggingface.co/SZLHOLDINGS/SZLHOLDINGS/resolve/main/assets/mark.svg" width="110" alt="SZL"/>
+# forge-v3
+**Doctrine-corpus-v2 SFT student (estate doctrine, source-grounded)**
+`TRAINED THROUGH THE FAIL-CLOSED LAUNCH CONTRACT` · `RESEARCH_CANDIDATE` · `NOT_PROMOTED`
+</div>
+---
+## Proof of training
+![launch-contract](https://huggingface.co/SZLHOLDINGS/SZLHOLDINGS/resolve/main/assets/launch-contract.svg)
+## Lineage — every pin immutable
+| Stage | Artifact | Pin |
+|---|---|---|
+| Student base | `szl-receiptagent-qwen35-0.8b-sft-v3` | `0340c300` |
+| Corpus | Doctrine-corpus-v2 SFT student (estate doctrine, source-grounded) | group-disjoint split, seed 3407 |
+| Admission | operator receipt, `ADMITTED_FOR_TRAINING`, Apache 2.0 | on file |
+| Trainer | szl-forge governed pipeline | [launch contract #708](https://github.com/szl-holdings/szl-forge/pull/708) |
+| Receipts | [model-eval-receipts](https://huggingface.co/datasets/SZLHOLDINGS/model-eval-receipts) | per-wave |
+## Honest status
+- ✅ Trained through the launch contract: immutable pins, disjoint holdout, corpus floor, admission receipt
+- ❌ Not promoted · not quality-certified · no broad benchmark
+- 📊 Evaluation on the group-disjoint holdout: pending publication
+<div align="center"><sub>SZL Holdings · Doctrine v11 LOCKED · failures stay published</sub></div>
 ## The estate
 |---|---|
 | Company | [szlholdings.com](https://szlholdings.com) |
 | Sponsors | [Become a sponsor](https://szlholdings.com/sponsors.html) |
+| GitHub | [szl-holdings](https://github.com/szl-holdings) |
+| Receipts chain | [frontier-54-runs](https://huggingface.co/datasets/SZLHOLDINGS/frontier-54-runs) |
 | Live dashboard | [SI command center](https://szlholdings-szlholdings-si.hf.space) |