Add model card

README.md

@@ -0,0 +1,75 @@
+---
+license: apache-2.0
+library_name: gguf
+base_model: HuggingFaceBio/Carbon-3B
+language:
+- dna
+tags:
+- dna
+- genomic
+- llama.cpp
+- gguf
+- hybriddna
+---
+
+# Carbon-3B GGUF
+
+GGUF (bf16) conversion of [HuggingFaceBio/Carbon-3B](https://huggingface.co/HuggingFaceBio/Carbon-3B) for use with [llama.cpp](https://github.com/ggml-org/llama.cpp).
+
+Carbon is a hybrid DNA / English language model that switches between Qwen3-4B-Base byte-level BPE for natural text and fixed 6-mer chunking for DNA inside `<dna>...</dna>` tags.
+
+## Requires llama.cpp with HybridDNATokenizer support
+
+Loading these GGUFs needs `LLAMA_VOCAB_TYPE_HYBRIDDNA`, which is not yet in upstream llama.cpp. Until the PR merges, build from the [`carbon-3b-tokenizer`](https://github.com/kashif/llama.cpp/tree/carbon-3b-tokenizer) branch:
+
+```bash
+git clone -b carbon-3b-tokenizer https://github.com/kashif/llama.cpp
+cd llama.cpp && cmake -B build && cmake --build build -j
+```
+
+## Files
+
+| File | Quant | Size |
+|---|---|---|
+| `carbon-3b-bf16.gguf` | bf16 (lossless from source) | 6.5 GB |
+
+## Usage
+
+### Basic DNA completion
+
+```bash
+./build/bin/llama-completion -m carbon-3b-bf16.gguf \
+    -p '<dna>ATGCGCTAGCTACGATCGATCGTAGCTAGCTAGCTAGCTACG' \
+    -n 64 --temp 0 -no-cnv
+```
+
+### Metadata-conditioned generation
+
+```bash
+./build/bin/llama-completion -m carbon-3b-bf16.gguf \
+    -p '<vertebrate_mammalian><protein_coding_region><dna>ATGCGCTAG' \
+    -n 64 --temp 0 -no-cnv
+```
+
+### Speculative decoding with Carbon-500M draft (~1.35x speedup)
+
+```bash
+./build/bin/llama-speculative \
+    -m  carbon-3b-bf16.gguf \
+    -md carbon-500m-bf16.gguf \
+    -p '<dna>ATGCGCTAGCTACGATCGATCGTAGCTAGCTAGCTAGCTACG' \
+    -n 256 --temp 0
+```
+
+## Tokenization parity
+
+For every prompt in the [test fixture](https://github.com/kashif/llama.cpp/blob/carbon-3b-tokenizer/models/ggml-vocab-hybriddna.gguf.inp), llama.cpp produces byte-for-byte identical token IDs to the Python `HybridDNATokenizer` (loaded with `trust_remote_code=True`).
+
+## See also
+
+- Source weights: [HuggingFaceBio/Carbon-3B](https://huggingface.co/HuggingFaceBio/Carbon-3B)
+- Other GGUF variants: [500M](https://huggingface.co/HuggingFaceBio/Carbon-500M-GGUF) · [3B](https://huggingface.co/HuggingFaceBio/Carbon-3B-GGUF) · [8B](https://huggingface.co/HuggingFaceBio/Carbon-8B-GGUF)
+
+## License
+
+Apache-2.0, inherited from the source model.