Release AICE-v1: README

README.md

@@ -0,0 +1,133 @@
+---
+language:
+- en
+- it
+pipeline_tag: text-generation
+tags:
+- gguf
+- code
+- instruct
+- llama
+---
+
+# MODEL_CARD - PINDARO AI CODE
+
+Date: 2026-03-02
+Model path: `e:\Pindaro\PINDARO AI CODE`
+
+## 1. Model Identity
+- Name: `PINDARO AI CODE`
+- Family: LLaMA-style causal LM
+- Intended role: coding assistant
+- Format support:
+  - Hugging Face (`model.safetensors`)
+  - No GGUF artifact in this folder
+
+## 2. Technical Specs
+- Architecture: `LlamaForCausalLM`
+- `model_type`: `llama`
+- Layers: `22`
+- Hidden size: `2048`
+- Attention heads: `32`
+- KV heads: `4`
+- Intermediate size: `5632`
+- Max context: `2048`
+- Vocab size: `32002`
+- Tensor count in safetensors: `201`
+- Parameter count (computed): `1,100,056,576`
+- Dtype in config: `float16`
+
+## 3. Chat / Prompt Format
+Template is aligned to registered special tokens:
+- `<|noesis|>` (id `32000`)
+- `<|end|>` (id `32001`)
+
+Configured template:
+````jinja
+{{ bos_token }}{% for message in messages %}<|noesis|>
+{% if message['role'] == 'system' %}### System
+{{ message['content'] }}
+{% elif message['role'] == 'user' %}### Question
+{{ message['content'] }}
+{% elif message['role'] == 'assistant' %}### Answer
+{{ message['content'] }}
+{% endif %}<|end|>
+{% endfor %}{% if add_generation_prompt %}<|noesis|>
+### Answer
+```
+{% endif %}
+````
+
+## 4. Local Artifact Integrity (SHA256)
+- `model.safetensors`: `F77C27B8BABF9FCAB83A7DC68BA58934E8C8C031C9F10B4B73E802D4FBFE0CEC`
+- `config.json`: `B37C45060F3E2F5F9B91903C9CCB32F3C21076E809954FDA6C01D987CD8F25CC`
+- `generation_config.json`: `6FF47E725C0EC6D0F1895670DE7EE68E61A4F99703F6C8E89AEA6AB14EA02DC3`
+- `tokenizer_config.json`: `4AE48D4963835B0767DC6510D1DF8AE76E636ED35BE021F02F5B344353BDFA21`
+- `tokenizer.model`: `9E556AFD44213B6BD1BE2B850EBBBD98F5481437A8021AFAF58EE7FB1818D347`
+
+## 5. Smoke Tests (2026-03-02)
+Environment:
+- Python `3.11.9`
+- Transformers `4.57.3`
+- Torch `2.10.0+cpu`
+
+Results:
+- AutoConfig load: PASS
+- AutoTokenizer load: PASS
+- AutoModel load: PASS
+- Chat-template render: PASS
+- Template special-token alignment: PASS
+- Deterministic generation: PASS
+
+Observed non-blocking warning:
+- Folder name with spaces may trigger a Python module-name warning in some runtimes.
+
+## 6. Known Issues
+1. Folder-name warning risk
+- `PINDARO AI CODE` has spaces; some tools warn on module naming.
+
+2. Attention-mask warning in some calls
+- As `pad_token` equals `eos_token`, pass `attention_mask` explicitly for stable behavior.
+
+## 7. Recommended Next Steps
+1. Optional packaging cleanup
+- Rename folder to a no-space slug (example: `PINDARO_AI_CODE`) when compatible with your deployment scripts.
+
+2. Add coding eval gate
+- HumanEval pass@1
+- MBPP subset
+- Prompt-format adherence checks
+
+## 8. Usage Example
+```python
+import torch
+from transformers import AutoTokenizer, AutoModelForCausalLM
+
+path = r"e:\Pindaro\PINDARO AI CODE"
+tokenizer = AutoTokenizer.from_pretrained(path, local_files_only=True)
+model = AutoModelForCausalLM.from_pretrained(path, local_files_only=True, dtype=torch.float16)
+
+messages = [
+    {"role": "system", "content": "You are a coding assistant."},
+    {"role": "user", "content": "Write a Python function add(a, b)."},
+]
+
+inputs = tokenizer.apply_chat_template(
+    messages,
+    tokenize=True,
+    add_generation_prompt=True,
+    return_tensors="pt",
+)
+outputs = model.generate(inputs, max_new_tokens=80, do_sample=False)
+print(tokenizer.decode(outputs[0], skip_special_tokens=False))
+```
+
+## 9. Limitations and Safety
+- No training-data statement is included in this folder.
+- No official benchmark sheet is included.
+- Code generation can be plausible but wrong; always run tests.
+
+## 10. Release Readiness
+Current status: READY FOR LOCAL USE.
+- Packaging/runtime blockers are resolved.
+- Remaining items are evaluation and packaging polish.