From 8e3a76f932eb868fb244befae735366fa8134fb0 Mon Sep 17 00:00:00 2001 From: ModelHub XC Date: Sat, 13 Jun 2026 10:54:16 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=9D=E5=A7=8B=E5=8C=96=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=EF=BC=8C=E7=94=B1ModelHub=20XC=E7=A4=BE=E5=8C=BA=E6=8F=90?= =?UTF-8?q?=E4=BE=9B=E6=A8=A1=E5=9E=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Model: reaperdoesntknow/Shepherd-Alpha Source: Original Platform --- .gitattributes | 36 +++++++++++ README.md | 137 +++++++++++++++++++++++++++++++++++++++++ chat_template.jinja | 89 ++++++++++++++++++++++++++ config.json | 63 +++++++++++++++++++ generation_config.json | 13 ++++ model.safetensors | 3 + tokenizer.json | 3 + tokenizer_config.json | 22 +++++++ 8 files changed, 366 insertions(+) create mode 100644 .gitattributes create mode 100644 README.md create mode 100644 chat_template.jinja create mode 100644 config.json create mode 100644 generation_config.json create mode 100644 model.safetensors create mode 100644 tokenizer.json create mode 100644 tokenizer_config.json diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..52373fe --- /dev/null +++ b/.gitattributes @@ -0,0 +1,36 @@ +*.7z filter=lfs diff=lfs merge=lfs -text +*.arrow filter=lfs diff=lfs merge=lfs -text +*.bin filter=lfs diff=lfs merge=lfs -text +*.bz2 filter=lfs diff=lfs merge=lfs -text +*.ckpt filter=lfs diff=lfs merge=lfs -text +*.ftz filter=lfs diff=lfs merge=lfs -text +*.gz filter=lfs diff=lfs merge=lfs -text +*.h5 filter=lfs diff=lfs merge=lfs -text +*.joblib filter=lfs diff=lfs merge=lfs -text +*.lfs.* filter=lfs diff=lfs merge=lfs -text +*.mlmodel filter=lfs diff=lfs merge=lfs -text +*.model filter=lfs diff=lfs merge=lfs -text +*.msgpack filter=lfs diff=lfs merge=lfs -text +*.npy filter=lfs diff=lfs merge=lfs -text +*.npz filter=lfs diff=lfs merge=lfs -text +*.onnx filter=lfs diff=lfs merge=lfs -text +*.ot filter=lfs diff=lfs merge=lfs -text +*.parquet filter=lfs diff=lfs merge=lfs -text +*.pb filter=lfs diff=lfs merge=lfs -text +*.pickle filter=lfs diff=lfs merge=lfs -text +*.pkl filter=lfs diff=lfs merge=lfs -text +*.pt filter=lfs diff=lfs merge=lfs -text +*.pth filter=lfs diff=lfs merge=lfs -text +*.rar filter=lfs diff=lfs merge=lfs -text +*.safetensors filter=lfs diff=lfs merge=lfs -text +saved_model/**/* filter=lfs diff=lfs merge=lfs -text +*.tar.* filter=lfs diff=lfs merge=lfs -text +*.tar filter=lfs diff=lfs merge=lfs -text +*.tflite filter=lfs diff=lfs merge=lfs -text +*.tgz filter=lfs diff=lfs merge=lfs -text +*.wasm filter=lfs diff=lfs merge=lfs -text +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text +*tfevents* filter=lfs diff=lfs merge=lfs -text +tokenizer.json filter=lfs diff=lfs merge=lfs -text diff --git a/README.md b/README.md new file mode 100644 index 0000000..38bd387 --- /dev/null +++ b/README.md @@ -0,0 +1,137 @@ +--- +license: apache-2.0 +language: +- en +tags: +- tactical-reasoning +- military +- defense-ai +- bicell-dispersal +- sft +- dual-perspective +- shepherd +- convergentintel +- qwen +- ai +base_model: Qwen/Qwen3-1.7B +datasets: +- ZennyKenny/tactical-military-reasoning-v.1.0 +library_name: transformers +pipeline_tag: text-generation +--- + +# Shepherd-Alpha + +**The first defense AI reasoning model on Hugging Face.** + +Shepherd-Alpha is a tactical reasoning model fine-tuned on dual-perspective military scenario analysis using BiCell Depth Dispersal — a novel training methodology that partitions transformer layers by abstraction depth and trains them asymmetrically to separate representation encoding from task-specific reasoning. + +Developed by [Convergent Intelligence LLC: Research Division](https://convergentintel.com) + +## What This Model Does + +Given a tactical scenario, Shepherd-Alpha produces structured dual-perspective analysis: +- **Attack reasoning** — how an adversary would exploit the situation +- **Defense reasoning** — how to counter, mitigate, and survive + +The model is trained to think like both attacker and defender simultaneously. A model that understands how to attack becomes a defender that anticipates. + +## Training Methodology: BiCell Depth Dispersal + +Standard fine-tuning updates all layers jointly, allowing co-adaptation that can mask shallow learning. BiCell Depth Dispersal forces genuine specialization: + +| Phase | Frozen | Training | Purpose | +|-------|--------|----------|---------| +| 1 | Upper layers (14-27) | Lower layers (0-13) | Foundations encode before specialization exists | +| 2 | Lower layers (0-13) | Upper layers (14-27) | Reasoning learns over frozen representations | +| 3 | None | All layers | Joint integration of asymmetric gradient history | + +All three backward passes accumulate gradients before a single optimizer step. The asymmetric gradient history forces each depth zone to develop independently before integration. + +**Key finding during training:** Lower layers consistently produce ~1.7x the gradient magnitude of upper layers during domain adaptation. The pretrained upper layers already possess sufficient reasoning capacity — the primary adaptation is teaching lower layers to encode tactical domain structure. This suggests that for domain-specific SFT, representation layers (not reasoning layers) are the bottleneck. + +### Training Details + +- **Base model:** Qwen/Qwen3-1.7B (28 layers, all full attention) +- **Dataset:** [ZennyKenny/tactical-military-reasoning-v.1.0](https://huggingface.co/datasets/ZennyKenny/tactical-military-reasoning-v.1.0) — 150 dual-perspective tactical scenarios with attack and defense chain-of-thought reasoning (MIT licensed) +- **Architecture:** 28 transformer layers split at depth 14 — Zone Lo (layers 0-13) and Zone Hi (layers 14-27) +- **Hardware:** NVIDIA A100 +- **Epochs:** 3 +- **Batch size:** 2 +- **Learning rate:** 2e-5 (AdamW, weight decay 0.01) +- **Precision:** bfloat16 +- **Label masking:** Loss computed only on assistant (reasoning) tokens, not scenario prompts + +## Usage + +```python +from transformers import AutoModelForCausalLM, AutoTokenizer + +model = AutoModelForCausalLM.from_pretrained("reaperdoesntknow/Shepherd-Alpha") +tokenizer = AutoTokenizer.from_pretrained("reaperdoesntknow/Shepherd-Alpha") + +messages = [ + { + "role": "user", + "content": "Analyze this tactical scenario.\n\nScenario: A mechanized platoon advancing through urban terrain detects a coordinated drone swarm from the northeast. Limited anti-air capability. Civilian structures restrict fields of fire." + } +] + +inputs = tokenizer.apply_chat_template( + messages, + add_generation_prompt=True, + tokenize=True, + return_dict=True, + return_tensors="pt", +) + +output = model.generate( + **inputs, + max_new_tokens=512, + temperature=0.7, + top_p=0.9, + do_sample=True, +) + +generated = output[0][inputs["input_ids"].shape[1]:] +print(tokenizer.decode(generated, skip_special_tokens=True)) +``` + +## The Shepherd Program + +Shepherd-Alpha is the first public model in the Shepherd family — an ongoing research program developing AI systems for autonomous defense applications. The program spans: + +- **Shepherd Doctrine** — a comprehensive counter-swarm and area defense blueprint covering 28+ subsystems across five concentric engagement layers +- **Shepherd AI** — tactical reasoning models trained on dual-perspective analysis (this model) +- **BiCell Dispersal** — a training methodology based on the B_i Cell Dispersal framework for stochastic layer partitioning during fine-tuning + +## Limitations + +- **Alpha release** — this is a research checkpoint, not a production system +- **Small training set** — 150 scenarios provides format and domain grounding but limited tactical depth. Future versions will incorporate augmented datasets with multi-model generated reasoning +- **Base model thinking mode** — Qwen3's pretrained `` generation pattern can override the structured output format. Use `enable_thinking=False` in generation config for cleaner output +- **Not a weapon system** — this model performs analysis and reasoning. It does not control, target, or actuate anything + +## Citation + +```bibtex +@misc{shepherd-alpha-2026, + title={Shepherd-Alpha: Tactical Reasoning via BiCell Depth Dispersal}, + author={Convergent Intelligence LLC}, + year={2026}, + url={https://huggingface.co/reaperdoesntknow/Shepherd-Alpha} +} +``` + +## Related Work + +- [Structure Over Scale](https://doi.org/10.57967/hf/5165) — Foundation paper on structure-first training methodologies +- [DualMind Methodology](https://doi.org/10.57967/hf/5184) — Dual-cognitive-mode SFT using EXPLORE/EXAMINE tokens +- [Discrepancy Calculus](https://doi.org/10.57967/hf/5194) — Mathematical framework grounding BiCell dispersal theory +- [B_i Cell Dispersal Framework](https://convergentintel.com) — Stochastic layer freezing grounded in DISC measure theory + +--- + +*Convergent Intelligence LLC: Research Division* +*"Structure beats scale. Collaboration beats hierarchy. Observation beats theory."* + diff --git a/chat_template.jinja b/chat_template.jinja new file mode 100644 index 0000000..01be9b3 --- /dev/null +++ b/chat_template.jinja @@ -0,0 +1,89 @@ +{%- if tools %} + {{- '<|im_start|>system\n' }} + {%- if messages[0].role == 'system' %} + {{- messages[0].content + '\n\n' }} + {%- endif %} + {{- "# Tools\n\nYou may call one or more functions to assist with the user query.\n\nYou are provided with function signatures within XML tags:\n" }} + {%- for tool in tools %} + {{- "\n" }} + {{- tool | tojson }} + {%- endfor %} + {{- "\n\n\nFor each function call, return a json object with function name and arguments within XML tags:\n\n{\"name\": , \"arguments\": }\n<|im_end|>\n" }} +{%- else %} + {%- if messages[0].role == 'system' %} + {{- '<|im_start|>system\n' + messages[0].content + '<|im_end|>\n' }} + {%- endif %} +{%- endif %} +{%- set ns = namespace(multi_step_tool=true, last_query_index=messages|length - 1) %} +{%- for message in messages[::-1] %} + {%- set index = (messages|length - 1) - loop.index0 %} + {%- if ns.multi_step_tool and message.role == "user" and message.content is string and not(message.content.startswith('') and message.content.endswith('')) %} + {%- set ns.multi_step_tool = false %} + {%- set ns.last_query_index = index %} + {%- endif %} +{%- endfor %} +{%- for message in messages %} + {%- if message.content is string %} + {%- set content = message.content %} + {%- else %} + {%- set content = '' %} + {%- endif %} + {%- if (message.role == "user") or (message.role == "system" and not loop.first) %} + {{- '<|im_start|>' + message.role + '\n' + content + '<|im_end|>' + '\n' }} + {%- elif message.role == "assistant" %} + {%- set reasoning_content = '' %} + {%- if message.reasoning_content is string %} + {%- set reasoning_content = message.reasoning_content %} + {%- else %} + {%- if '' in content %} + {%- set reasoning_content = content.split('')[0].rstrip('\n').split('')[-1].lstrip('\n') %} + {%- set content = content.split('')[-1].lstrip('\n') %} + {%- endif %} + {%- endif %} + {%- if loop.index0 > ns.last_query_index %} + {%- if loop.last or (not loop.last and reasoning_content) %} + {{- '<|im_start|>' + message.role + '\n\n' + reasoning_content.strip('\n') + '\n\n\n' + content.lstrip('\n') }} + {%- else %} + {{- '<|im_start|>' + message.role + '\n' + content }} + {%- endif %} + {%- else %} + {{- '<|im_start|>' + message.role + '\n' + content }} + {%- endif %} + {%- if message.tool_calls %} + {%- for tool_call in message.tool_calls %} + {%- if (loop.first and content) or (not loop.first) %} + {{- '\n' }} + {%- endif %} + {%- if tool_call.function %} + {%- set tool_call = tool_call.function %} + {%- endif %} + {{- '\n{"name": "' }} + {{- tool_call.name }} + {{- '", "arguments": ' }} + {%- if tool_call.arguments is string %} + {{- tool_call.arguments }} + {%- else %} + {{- tool_call.arguments | tojson }} + {%- endif %} + {{- '}\n' }} + {%- endfor %} + {%- endif %} + {{- '<|im_end|>\n' }} + {%- elif message.role == "tool" %} + {%- if loop.first or (messages[loop.index0 - 1].role != "tool") %} + {{- '<|im_start|>user' }} + {%- endif %} + {{- '\n\n' }} + {{- content }} + {{- '\n' }} + {%- if loop.last or (messages[loop.index0 + 1].role != "tool") %} + {{- '<|im_end|>\n' }} + {%- endif %} + {%- endif %} +{%- endfor %} +{%- if add_generation_prompt %} + {{- '<|im_start|>assistant\n' }} + {%- if enable_thinking is defined and enable_thinking is false %} + {{- '\n\n\n\n' }} + {%- endif %} +{%- endif %} \ No newline at end of file diff --git a/config.json b/config.json new file mode 100644 index 0000000..71a7beb --- /dev/null +++ b/config.json @@ -0,0 +1,63 @@ +{ + "architectures": [ + "Qwen3ForCausalLM" + ], + "attention_bias": false, + "attention_dropout": 0.0, + "bos_token_id": 151643, + "dtype": "bfloat16", + "eos_token_id": 151645, + "head_dim": 128, + "hidden_act": "silu", + "hidden_size": 2048, + "initializer_range": 0.02, + "intermediate_size": 6144, + "layer_types": [ + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention", + "full_attention" + ], + "max_position_embeddings": 40960, + "max_window_layers": 28, + "model_type": "qwen3", + "num_attention_heads": 16, + "num_hidden_layers": 28, + "num_key_value_heads": 8, + "pad_token_id": null, + "rms_norm_eps": 1e-06, + "rope_parameters": { + "rope_theta": 1000000, + "rope_type": "default" + }, + "sliding_window": null, + "tie_word_embeddings": true, + "transformers_version": "5.0.0", + "use_cache": true, + "use_sliding_window": false, + "vocab_size": 151675 +} diff --git a/generation_config.json b/generation_config.json new file mode 100644 index 0000000..6ef4252 --- /dev/null +++ b/generation_config.json @@ -0,0 +1,13 @@ +{ + "bos_token_id": 151643, + "do_sample": true, + "eos_token_id": [ + 151645, + 151643 + ], + "pad_token_id": 151643, + "temperature": 0.6, + "top_k": 20, + "top_p": 0.95, + "transformers_version": "5.0.0" +} diff --git a/model.safetensors b/model.safetensors new file mode 100644 index 0000000..074171b --- /dev/null +++ b/model.safetensors @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:880243c7e62335f0ee8053440c666bed640d50f2d87f46b9d4eb89a844357e35 +size 3440116552 diff --git a/tokenizer.json b/tokenizer.json new file mode 100644 index 0000000..efc0370 --- /dev/null +++ b/tokenizer.json @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9ac045cd8ace1af66e21df429a0ddc88fe6580b7c567e9b963819c6247873cb8 +size 11423769 diff --git a/tokenizer_config.json b/tokenizer_config.json new file mode 100644 index 0000000..3ec5d2d --- /dev/null +++ b/tokenizer_config.json @@ -0,0 +1,22 @@ +{ + "add_prefix_space": false, + "backend": "tokenizers", + "bos_token": null, + "clean_up_tokenization_spaces": false, + "eos_token": "<|im_end|>", + "errors": "replace", + "extra_special_tokens": [ + "", + "", + "", + "", + "", + "" + ], + "is_local": true, + "model_max_length": 131072, + "pad_token": "<|endoftext|>", + "split_special_tokens": false, + "tokenizer_class": "Qwen2Tokenizer", + "unk_token": null +}