Update Brainstem 1 public release scaffold

.gitattributes

@@ -1,35 +1,35 @@
-*.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
+*.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

LICENSE

@@ -0,0 +1,5 @@
+Apache License 2.0
+
+Copyright (c) YEAR
+
+See LICENSE file for full terms.

README.md

@@ -1,3 +1,39 @@
 ---
 license: apache-2.0
+tags:
+  - text-generation
+  - saas
+  - public-release
+base_model: Qwen/Qwen2.5-1.5B-Instruct
 ---
+
+# Brainstem 1
+
+Brainstem 1 is the first public release built from the private `brainstem` development line.
+
+## Upgrade Position
+
+```text
+brainstem-3 > brainstem-2 > brainstem-1
+```
+
+Use Brainstem 1 as the baseline public release. Users should upgrade to Brainstem 2 or Brainstem 3 when they are available.
+
+## Status
+
+This folder is currently a release scaffold. It does not yet contain real model weights.
+
+## Release Checklist
+
+- Confirm whether this release is a full merged model or a LoRA adapter.
+- Add real model weights.
+- Use `Qwen/Qwen2.5-1.5B-Instruct` as the upstream base model.
+- Add evaluation results.
+- Add example usage.
+- Confirm no private SaaS data is included.
+
+## Upgrade Notes
+
+- Baseline Supernerve product Q&A.
+- Baseline tone and guardrails.
+- Initial public release for testing.

config.json

@@ -0,0 +1,5 @@
+{
+  "model": "your-model-name",
+  "framework": "pytorch",
+  "task": "text-generation"
+}

data/format.md

@@ -0,0 +1,9 @@
+Dataset format:
+
+- JSONL or JSON array with objects containing `input` and `output` fields.
+
+Example:
+
+```
+{"input": "question", "output": "answer"}
+```

data/sample.json

@@ -0,0 +1,3 @@
+[
+  {"input": "Hello, world!", "output": "Hi there!"}
+]

docs/architecture.md

@@ -0,0 +1 @@
+Architecture notes placeholder.

docs/limitations.md

@@ -0,0 +1 @@
+Limitations placeholder. Describe model limitations and known failure modes.

eval/benchmarks.md

@@ -0,0 +1 @@
+Evaluation benchmarks and protocols should be described here.

eval/eval_results.json

@@ -0,0 +1 @@
+{}

examples/api_usage.py

@@ -0,0 +1,5 @@
+def example_api_usage():
+    print("API usage example placeholder")
+
+if __name__ == '__main__':
+    example_api_usage()

examples/chat.py

@@ -0,0 +1,5 @@
+def chat():
+    print("Chat example placeholder")
+
+if __name__ == '__main__':
+    chat()

examples/inference.py

@@ -0,0 +1,5 @@
+def run():
+    print("Inference example placeholder")
+
+if __name__ == '__main__':
+    run()

generation_config.json

@@ -0,0 +1,5 @@
+{
+  "max_length": 256,
+  "temperature": 0.8,
+  "top_p": 0.9
+}

special_tokens_map.json

@@ -0,0 +1,6 @@
+{
+  "bos_token": "<s>",
+  "eos_token": "</s>",
+  "pad_token": "<pad>",
+  "unk_token": "<unk>"
+}

tokenizer.json

@@ -0,0 +1,4 @@
+{
+  "tokenizer": "placeholder",
+  "vocab_size": 32000
+}

tokenizer_config.json

@@ -0,0 +1,4 @@
+{
+  "do_lower_case": false,
+  "max_len": 512
+}

training/config.yaml

@@ -0,0 +1,7 @@
+training:
+  epochs: 3
+  batch_size: 8
+  learning_rate: 1e-4
+
+model:
+  name: your-model-name

training/finetune_lora.py

@@ -0,0 +1,5 @@
+def main():
+    print("Fine-tune (LoRA) script placeholder")
+
+if __name__ == '__main__':
+    main()

training/requirements.txt

@@ -0,0 +1,4 @@
+torch
+transformers
+datasets
+peft

training/train.py

@@ -0,0 +1,5 @@
+def main():
+    print("Training script placeholder")
+
+if __name__ == '__main__':
+    main()