Upload folder using huggingface_hub

README.md

@@ -0,0 +1,57 @@
+---
+library_name: residuals
+base_model: google/gemma-3-4b-pt
+base_model_relation: adapter
+instruct_model: google/gemma-3-4b-it
+pipeline_tag: text-generation
+tags:
+- residuals
+- delta
+- task-arithmetic
+- finetune
+---
+
+
+# Instruction Residuals
+
+This repository contains instruction residuals (delta weights) computed as the parameter-wise difference between `google/gemma-3-4b-it` and `google/gemma-3-4b-pt`.
+
+Apply these residuals to the base model to reconstruct the instruction-tuned weights without retraining.
+
+
+## Usage
+
+```python
+from transformers import AutoModelForCausalLM, AutoTokenizer
+from residuals import Residuals
+
+base = AutoModelForCausalLM.from_pretrained("google/gemma-3-4b-pt")
+tok = AutoTokenizer.from_pretrained("google/gemma-3-4b-pt")
+
+res = Residuals.from_pretrained("residuals/gemma-3-4b")
+res.apply(base, base_tokenizer=tok)
+```
+
+
+## Provenance
+- **Created at**: 2025-10-25T18:45:30.975057+00:00
+- **DType**: float32
+- **Parameters**: 884
+- **Shapes hash**: 0aad859058a45de47ddd36c2e67a97e30be0a99b7da51dcfb62e4797e27328d8
+- **Names hash**: 22ce2085d7e0c22fd49d378204b2df3f6a4013610f03e7102733ed62b50259c3
+- **Base model**: `google/gemma-3-4b-pt`
+- **Instruction model**: `google/gemma-3-4b-it`
+
+## Files
+- **model.safetensors**: Serialized residual tensors (safetensors format).
+- (optional) **model.safetensors.index.json** + shard files `model-00001-of-000N.safetensors`, ... for multi-part weights.
+- **config.json**: Residuals metadata and provenance.
+- **tokenizer files**: Saved tokenizer for compatibility.
+
+## About this format
+These are additive residuals (task vectors). Applying them to the base model's parameters reconstructs the instruction-tuned model.
+
+## Tools
+Generated with the `residuals` Python package. Install via: `pip install residuals`.
+- PyPI: https://pypi.org/project/residuals/
+- Source: https://github.com/omarish/residuals

added_tokens.json

@@ -0,0 +1,3 @@
+{
+  "<image_soft_token>": 262144
+}

chat_template.jinja

@@ -0,0 +1,47 @@
+{{ bos_token }}
+{%- if messages[0]['role'] == 'system' -%}
+    {%- if messages[0]['content'] is string -%}
+        {%- set first_user_prefix = messages[0]['content'] + '
+
+' -%}
+    {%- else -%}
+        {%- set first_user_prefix = messages[0]['content'][0]['text'] + '
+
+' -%}
+    {%- endif -%}
+    {%- set loop_messages = messages[1:] -%}
+{%- else -%}
+    {%- set first_user_prefix = "" -%}
+    {%- set loop_messages = messages -%}
+{%- endif -%}
+{%- for message in loop_messages -%}
+    {%- if (message['role'] == 'user') != (loop.index0 % 2 == 0) -%}
+        {{ raise_exception("Conversation roles must alternate user/assistant/user/assistant/...") }}
+    {%- endif -%}
+    {%- if (message['role'] == 'assistant') -%}
+        {%- set role = "model" -%}
+    {%- else -%}
+        {%- set role = message['role'] -%}
+    {%- endif -%}
+    {{ '<start_of_turn>' + role + '
+' + (first_user_prefix if loop.first else "") }}
+    {%- if message['content'] is string -%}
+        {{ message['content'] | trim }}
+    {%- elif message['content'] is iterable -%}
+        {%- for item in message['content'] -%}
+            {%- if item['type'] == 'image' -%}
+                {{ '<start_of_image>' }}
+            {%- elif item['type'] == 'text' -%}
+                {{ item['text'] | trim }}
+            {%- endif -%}
+        {%- endfor -%}
+    {%- else -%}
+        {{ raise_exception("Invalid content type") }}
+    {%- endif -%}
+    {{ '<end_of_turn>
+' }}
+{%- endfor -%}
+{%- if add_generation_prompt -%}
+    {{'<start_of_turn>model
+'}}
+{%- endif -%}

config.json

@@ -0,0 +1,25 @@
+{
+  "residuals_version": "1.0",
+  "format": "pytorch",
+  "dtype": "float32",
+  "param_count": 884,
+  "shapes_hash": "0aad859058a45de47ddd36c2e67a97e30be0a99b7da51dcfb62e4797e27328d8",
+  "parameter_names_hash": "22ce2085d7e0c22fd49d378204b2df3f6a4013610f03e7102733ed62b50259c3",
+  "tokenizer_name": "google/gemma-3-4b-it",
+  "created_at": "2025-10-25T18:45:30.975057+00:00",
+  "library": {
+    "package": "residuals"
+  },
+  "base_model_name": "google/gemma-3-4b-pt",
+  "instruct_model_name": "google/gemma-3-4b-it",
+  "pipeline_tag": "text-generation",
+  "license": null,
+  "language": null,
+  "tags": [
+    "residuals",
+    "delta",
+    "task-arithmetic",
+    "finetune"
+  ],
+  "base_model_relation": "adapter"
+}

model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:303ba64a04f552541c699e1583772fced1b6802a7ee3c361f389c27809ffba3a
+size 19885450136

special_tokens_map.json

@@ -0,0 +1,33 @@
+{
+  "boi_token": "<start_of_image>",
+  "bos_token": {
+    "content": "<bos>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "eoi_token": "<end_of_image>",
+  "eos_token": {
+    "content": "<eos>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "image_token": "<image_soft_token>",
+  "pad_token": {
+    "content": "<pad>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  },
+  "unk_token": {
+    "content": "<unk>",
+    "lstrip": false,
+    "normalized": false,
+    "rstrip": false,
+    "single_word": false
+  }
+}

tokenizer.model

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1299c11d7cf632ef3b4e11937501358ada021bbdf7c47638d13c0ee982f2e79c
+size 4689074