Restore the card after the sync flattened it again

README.md

@@ -14,6 +14,7 @@ tags:
 pipeline_tag: text-generation
 ---
 
+<!-- card-header:start (generated from manifest.json, edit below this block) -->
 # Title
 
 Names what you just wrote.
@@ -21,3 +22,103 @@ Names what you just wrote.
 On-device titles and descriptions: a short factual title and a one- to two-sentence description for any passage of text.
 
 - **SDKs, install and examples:** https://github.com/Desert-Ant-Labs/desert-ant-core/blob/main/docs/models/title.md
+
+<!-- card-header:end -->
+
+<!-- card-install:start (generated from manifest.json, edit below this block) -->
+| | |
+| --- | --- |
+| **Platforms** | iOS, macOS, tvOS, visionOS |
+| **Weights** | [v0.1.0](https://huggingface.co/desert-ant-labs/title) |
+
+## Install
+
+**Swift** ([requirements](https://github.com/Desert-Ant-Labs/desert-ant-core/blob/main/README.md#swift))
+
+```swift
+.package(url: "https://github.com/Desert-Ant-Labs/desert-ant-core.git", from: "3.0.0",
+        traits: ["MLX"])
+```
+
+Then add the `Title` product to your target. The `MLX` trait is required: without it the module compiles as a stub.
+<!-- card-install:end -->
+
+
+Get a title and a one or two sentence description for any passage of text, on device.
+
+Fine-tuned on transcript clips, but it works on any prose. The register is deliberately plain, with no emoji, no hashtags and no clickbait,
+and a description is meant to identify *this* passage rather than its topic.
+
+## Files
+
+An MLX model directory. Load the folder, not a single file.
+
+| File | Contents |
+|---|---|
+| `model.safetensors` | 6-bit quantized weights |
+| `model.safetensors.index.json` | shard index; present even for one shard, because the loader reads it |
+| `config.json` | architecture and quantization config |
+| `generation_config.json` | decode defaults |
+| `tokenizer.json`, `tokenizer_config.json` | byte-level BPE with merges |
+| `chat_template.jinja` | the chat template the fine-tune was trained against |
+
+The chat template is not incidental. A different template is a different task to this model.
+
+## The prompt
+
+The model was fine-tuned against one specific instruction, and a paraphrase is a different
+task to it. It lives in `Titles.prompt` in the SDK; use that wording. The reply is two labelled
+lines:
+
+```
+TITLE: <3-8 words, no final punctuation>
+DESC: <1-2 sentences>
+```
+
+Parse tolerantly. A card model that drifts off format should degrade to a usable title rather
+than throw.
+
+## Apple only
+
+MLX runs on Apple silicon and nowhere else, so there is no Android, Linux or Windows artifact
+here and no manifest promising one. A Core ML export exists in the training repository and is
+kept as evidence rather than as a candidate: on short autoregressive decode the Neural Engine
+is bandwidth-bound, and the Core ML arm lost on first token, throughput, load time and resident
+memory.
+
+## Status
+
+Internal testing, and less settled than that phrase usually implies. This card carries no
+quality figures: no independent review has been completed, and a known open issue is that the
+model sometimes opens a description with a stock phrase its own instruction forbids. Treat the
+output as needing a read before it reaches a user.
+
+## Built on
+
+- [`ibm-granite/granite-4.0-350m`](https://huggingface.co/ibm-granite/granite-4.0-350m) , 
+  the base model this is fine-tuned from.
+
+<!-- card-footer:start (generated from manifest.json, edit above this block) -->
+## License
+
+[Desert Ant Labs Source-Available License](https://license.desertant.com/1.0). Free for most
+apps, and a commercial license is required at scale. Full terms are at the link.
+Licensing: <licensing@desertant.com>.
+
+See [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).
+
+## Citation
+
+```bibtex
+@software{title_2026,
+  title  = {Title: On-device titles and descriptions: a short factual title and a one- to two-sentence description for any passage of text},
+  author = {Desert Ant Labs},
+  year   = {2026},
+  url    = {https://huggingface.co/desert-ant-labs/title},
+}
+```
+
+---
+
+© 2026 Desert Ant Labs · <https://desertant.com>
+<!-- card-footer:end -->