Update README.md

README.md

@@ -1,25 +1,1039 @@
 ---
+base_model: Jackrong/Qwopus3.5-9B-Coder
+datasets:
+- guell00/Coder-max
+language:
+- pt
+- en
+- es
+- fr
+- de
+- it
+- ja
+- zh
+- ru
+- tr
+pipeline_tag: text-generation
 tags:
+- code
+- coding
+- coder
+- qwen
+- qwen3.5
 - gguf
-- llama.cpp
 - unsloth
-- vision-language-model
+- lora
+- sft
+- html
+- css
+- javascript
+- threejs
+- canvas
+- python
+- multilingual
 ---
 
-# OBSIDIAN-9B-Coder : GGUF
+<div align="center">
 
-This model was finetuned and converted to GGUF format using [Unsloth](https://github.com/unslothai/unsloth).
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 360" width="100%" height="auto">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#050507"/>
+      <stop offset="45%" stop-color="#0d0914"/>
+      <stop offset="100%" stop-color="#071116"/>
+    </linearGradient>
 
-**Example usage**:
-- For text only LLMs:    `llama-cli -hf guell00/OBSIDIAN-9B-Coder --jinja`
-- For multimodal models: `llama-mtmd-cli -hf guell00/OBSIDIAN-9B-Coder --jinja`
+    <linearGradient id="obsidian" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#7c3aed"/>
+      <stop offset="45%" stop-color="#c026d3"/>
+      <stop offset="100%" stop-color="#06b6d4"/>
+    </linearGradient>
 
-## Available Model files:
-- `Qwopus3.5-9B-Coder.Q3_K_M.gguf`
-- `Qwopus3.5-9B-Coder.Q8_0.gguf`
-- `Qwopus3.5-9B-Coder.Q6_K.gguf`
-- `Qwopus3.5-9B-Coder.Q5_K_M.gguf`
-- `Qwopus3.5-9B-Coder.Q4_K_M.gguf`
-- `Qwopus3.5-9B-Coder.BF16-mmproj.gguf`
-This was trained 2x faster with [Unsloth](https://github.com/unslothai/unsloth)
-[<img src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/unsloth%20made%20with%20love.png" width="200"/>](https://github.com/unslothai/unsloth)
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="5" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <rect width="1200" height="360" rx="22" fill="url(#bg)"/>
+
+  <rect x="2" y="2" width="1196" height="356" rx="20"
+        fill="none"
+        stroke="url(#obsidian)"
+        stroke-width="2"
+        opacity="0.5"/>
+
+  <g opacity="0.07" stroke="#a855f7">
+    <path d="M0 90H1200 M0 180H1200 M0 270H1200"/>
+    <path d="M150 0V360 M300 0V360 M450 0V360 M600 0V360 M750 0V360 M900 0V360 M1050 0V360"/>
+  </g>
+
+  <g transform="translate(85,70)" filter="url(#glow)">
+    <path d="M100 0 L180 62 L155 185 L100 225 L45 185 L20 62 Z"
+          fill="#0c0912"
+          stroke="url(#obsidian)"
+          stroke-width="3"/>
+
+    <path d="M100 25 L145 75 L128 160 L100 195 L72 160 L55 75 Z"
+          fill="#171020"
+          stroke="#8b5cf6"
+          stroke-width="2"/>
+
+    <path d="M100 45 L120 100 L100 170 L80 100 Z"
+          fill="url(#obsidian)"/>
+  </g>
+
+  <text x="330" y="125"
+        font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif"
+        font-size="58"
+        font-weight="900"
+        fill="url(#obsidian)"
+        letter-spacing="3">
+    OBSIDIAN
+  </text>
+
+  <text x="334" y="177"
+        font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif"
+        font-size="30"
+        font-weight="800"
+        fill="#e2e8f0"
+        letter-spacing="6">
+    9B CODER
+  </text>
+
+  <text x="334" y="218"
+        font-family="monospace"
+        font-size="16"
+        fill="#94a3b8">
+    QWEN CODER • MULTILINGUAL • FRONTEND SPECIALIZED
+  </text>
+
+  <g transform="translate(334,250)">
+    <rect width="130" height="30" rx="15"
+          fill="#7c3aed"
+          fill-opacity="0.18"/>
+    <text x="65" y="20"
+          text-anchor="middle"
+          font-family="monospace"
+          font-size="12"
+          fill="#c4b5fd">
+      THREE.JS
+    </text>
+
+    <rect x="145" width="130" height="30" rx="15"
+          fill="#c026d3"
+          fill-opacity="0.16"/>
+    <text x="210" y="20"
+          text-anchor="middle"
+          font-family="monospace"
+          font-size="12"
+          fill="#f0abfc">
+      JAVASCRIPT
+    </text>
+
+    <rect x="290" width="130" height="30" rx="15"
+          fill="#2563eb"
+          fill-opacity="0.16"/>
+    <text x="355" y="20"
+          text-anchor="middle"
+          font-family="monospace"
+          font-size="12"
+          fill="#93c5fd">
+      HTML/CSS
+    </text>
+
+    <rect x="435" width="130" height="30" rx="15"
+          fill="#0891b2"
+          fill-opacity="0.16"/>
+    <text x="500" y="20"
+          text-anchor="middle"
+          font-family="monospace"
+          font-size="12"
+          fill="#67e8f9">
+      CANVAS
+    </text>
+  </g>
+
+  <text x="334" y="320"
+        font-family="monospace"
+        font-size="13"
+        fill="#64748b">
+    FORGED FOR COMPLETE CODE GENERATION
+  </text>
+</svg>
+
+</div>
+
+# OBSIDIAN-9B-Coder
+
+**OBSIDIAN-9B-Coder** is a 9B coding model fine-tuned on the **Coder Max Multilingual** dataset.
+
+The model is specialized in generating **complete software implementations**, with a strong focus on modern frontend development, interactive browser applications, Three.js, HTML5 Canvas, JavaScript, HTML/CSS and general programming.
+
+> **Complete code. Long context. Interactive software.**
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 125" width="100%">
+  <rect width="1200" height="125" rx="18"
+        fill="#08080d"
+        stroke="#312e81"
+        stroke-opacity="0.7"/>
+
+  <g font-family="monospace" text-anchor="middle">
+
+    <text x="120" y="48"
+          font-size="27"
+          font-weight="900"
+          fill="#c4b5fd">9B</text>
+    <text x="120" y="78"
+          font-size="11"
+          fill="#64748b">MODEL CLASS</text>
+
+    <text x="360" y="48"
+          font-size="27"
+          font-weight="900"
+          fill="#67e8f9">32K</text>
+    <text x="360" y="78"
+          font-size="11"
+          fill="#64748b">TRAINING CONTEXT</text>
+
+    <text x="600" y="48"
+          font-size="27"
+          font-weight="900"
+          fill="#f0abfc">10</text>
+    <text x="600" y="78"
+          font-size="11"
+          fill="#64748b">LANGUAGES</text>
+
+    <text x="840" y="48"
+          font-size="27"
+          font-weight="900"
+          fill="#93c5fd">LoRA</text>
+    <text x="840" y="78"
+          font-size="11"
+          fill="#64748b">SFT</text>
+
+    <text x="1080" y="48"
+          font-size="27"
+          font-weight="900"
+          fill="#86efac">GGUF</text>
+    <text x="1080" y="78"
+          font-size="11"
+          fill="#64748b">READY</text>
+
+  </g>
+</svg>
+
+</div>
+
+## Overview
+
+OBSIDIAN-9B-Coder was created to specialize a Qwen-based coding model toward **implementation-heavy programming tasks**.
+
+Instead of focusing primarily on explanations surrounding code, the fine-tuning corpus heavily emphasizes the generation of the actual implementation.
+
+The model is particularly suited for:
+
+- Complete single-file web applications
+- HTML5 and modern CSS
+- JavaScript ES6+
+- Three.js
+- HTML5 Canvas
+- Interactive browser applications
+- Games and graphical experiments
+- DOM manipulation
+- Animation loops
+- State management
+- Python
+- Algorithmic programming
+- Multilingual programming instructions
+
+---
+
+## Core Philosophy
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 220" width="100%">
+  <defs>
+    <linearGradient id="flow" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#7c3aed"/>
+      <stop offset="50%" stop-color="#c026d3"/>
+      <stop offset="100%" stop-color="#0891b2"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="1200" height="220" rx="18"
+        fill="#07070b"
+        stroke="#27272a"/>
+
+  <text x="600" y="40"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="15"
+        font-weight="700"
+        fill="#c4b5fd">
+    FROM PROMPT TO COMPLETE SOFTWARE
+  </text>
+
+  <g font-family="monospace" text-anchor="middle">
+
+    <rect x="75" y="80" width="230" height="70" rx="14"
+          fill="#120d1b"
+          stroke="#7c3aed"/>
+
+    <text x="190" y="109"
+          font-size="14"
+          fill="#ddd6fe">
+      USER REQUEST
+    </text>
+
+    <text x="190" y="132"
+          font-size="11"
+          fill="#64748b">
+      natural language
+    </text>
+
+    <path d="M305 115H445"
+          stroke="url(#flow)"
+          stroke-width="4"/>
+
+    <path d="M432 105L445 115L432 125"
+          fill="none"
+          stroke="#c026d3"
+          stroke-width="4"/>
+
+    <rect x="445" y="80" width="310" height="70" rx="14"
+          fill="#150d18"
+          stroke="#c026d3"/>
+
+    <text x="600" y="109"
+          font-size="14"
+          fill="#f5d0fe">
+      OBSIDIAN-9B-CODER
+    </text>
+
+    <text x="600" y="132"
+          font-size="11"
+          fill="#64748b">
+      generate + construct
+    </text>
+
+    <path d="M755 115H895"
+          stroke="url(#flow)"
+          stroke-width="4"/>
+
+    <path d="M882 105L895 115L882 125"
+          fill="none"
+          stroke="#0891b2"
+          stroke-width="4"/>
+
+    <rect x="895" y="80" width="230" height="70" rx="14"
+          fill="#07171b"
+          stroke="#0891b2"/>
+
+    <text x="1010" y="109"
+          font-size="14"
+          fill="#a5f3fc">
+      COMPLETE CODE
+    </text>
+
+    <text x="1010" y="132"
+          font-size="11"
+          fill="#64748b">
+      full implementation
+    </text>
+
+  </g>
+
+  <text x="600" y="190"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="11"
+        fill="#52525b">
+    LESS BOILERPLATE • MORE IMPLEMENTATION • COMPLETE OUTPUTS
+  </text>
+</svg>
+
+</div>
+
+---
+
+# GGUF
+
+This model was fine-tuned and converted to **GGUF** format using **Unsloth**.
+
+The repository contains multiple quantizations so users can select the appropriate balance between model size, memory usage and output quality.
+
+## Available Model Files
+
+| File | Quantization | Notes |
+|---|---|---|
+| `Qwopus3.5-9B-Coder.Q8_0.gguf` | Q8_0 | Highest-quality quantized version |
+| `Qwopus3.5-9B-Coder.Q6_K.gguf` | Q6_K | High quality with reduced size |
+| `Qwopus3.5-9B-Coder.Q5_K_M.gguf` | Q5_K_M | Strong quality/size balance |
+| `Qwopus3.5-9B-Coder.Q4_K_M.gguf` | Q4_K_M | Recommended balance for local use |
+| `Qwopus3.5-9B-Coder.Q3_K_M.gguf` | Q3_K_M | Lower memory requirement |
+| `Qwopus3.5-9B-Coder.BF16-mmproj.gguf` | BF16 mmproj | Multimodal projector artifact |
+
+---
+
+## llama.cpp
+
+For compatible text-generation configurations:
+
+```bash
+llama-cli -hf guell00/OBSIDIAN-9B-Coder --jinja
+```
+
+For compatible multimodal configurations:
+
+```bash
+llama-mtmd-cli -hf guell00/OBSIDIAN-9B-Coder --jinja
+```
+
+Depending on your environment and the files selected automatically by `llama.cpp`, you may want to explicitly choose a GGUF quantization.
+
+---
+
+## Quantization Guide
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 310" width="100%">
+  <rect width="1200" height="310" rx="20"
+        fill="#08080d"
+        stroke="#27272a"/>
+
+  <text x="600" y="42"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="16"
+        font-weight="700"
+        fill="#c4b5fd">
+    GGUF QUANTIZATION LADDER
+  </text>
+
+  <g font-family="monospace">
+
+    <text x="90" y="92" fill="#94a3b8">Q8_0</text>
+    <rect x="200" y="75" width="780" height="20" rx="10" fill="#18181b"/>
+    <rect x="200" y="75" width="760" height="20" rx="10" fill="#7c3aed"/>
+    <text x="1010" y="91" fill="#c4b5fd">QUALITY</text>
+
+    <text x="90" y="132" fill="#94a3b8">Q6_K</text>
+    <rect x="200" y="115" width="780" height="20" rx="10" fill="#18181b"/>
+    <rect x="200" y="115" width="700" height="20" rx="10" fill="#8b5cf6"/>
+    <text x="1010" y="131" fill="#c4b5fd">HIGH</text>
+
+    <text x="90" y="172" fill="#94a3b8">Q5_K_M</text>
+    <rect x="200" y="155" width="780" height="20" rx="10" fill="#18181b"/>
+    <rect x="200" y="155" width="640" height="20" rx="10" fill="#c026d3"/>
+    <text x="1010" y="171" fill="#f0abfc">BALANCED+</text>
+
+    <text x="90" y="212" fill="#94a3b8">Q4_K_M</text>
+    <rect x="200" y="195" width="780" height="20" rx="10" fill="#18181b"/>
+    <rect x="200" y="195" width="570" height="20" rx="10" fill="#2563eb"/>
+    <text x="1010" y="211" fill="#93c5fd">BALANCED</text>
+
+    <text x="90" y="252" fill="#94a3b8">Q3_K_M</text>
+    <rect x="200" y="235" width="780" height="20" rx="10" fill="#18181b"/>
+    <rect x="200" y="235" width="470" height="20" rx="10" fill="#0891b2"/>
+    <text x="1010" y="251" fill="#67e8f9">COMPACT</text>
+
+  </g>
+
+  <text x="600" y="288"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="11"
+        fill="#52525b">
+    MORE BITS → MORE MEMORY • FEWER BITS → SMALLER FOOTPRINT
+  </text>
+</svg>
+
+</div>
+
+For most local deployments, **Q4_K_M** or **Q5_K_M** are reasonable starting points.
+
+Use **Q8_0** when memory is less constrained and preserving model quality is more important.
+
+---
+
+# Training Dataset
+
+OBSIDIAN-9B-Coder was fine-tuned using:
+
+**Coder Max Multilingual**  
+`guell00/Coder-max`
+
+Coder Max is a conversational supervised fine-tuning dataset focused heavily on code generation.
+
+The corpus was designed to contain complete implementations instead of heavily truncated programming answers.
+
+## Dataset Characteristics
+
+| Characteristic | Description |
+|---|---|
+| Format | JSONL |
+| Structure | Conversational messages |
+| Training type | Supervised Fine-Tuning |
+| Languages | 10 |
+| Main content | Programming |
+| Code density | ~95%+ |
+| Frontend focus | Strong |
+| Three.js specialization | Strong |
+| Long code outputs | Preserved |
+
+---
+
+## Dataset Scale
+
+Coder Max is distributed in incremental variants.
+
+| Variant | Physical Size | Records | Messages | Code Density |
+|---|---:|---:|---:|---:|
+| `001MB` | 3,739,874 B | 109 | 220 | 99.08% |
+| `010MB` | 12,709,008 B | 969 | 2,012 | 96.18% |
+| `100MB` | 102,679,666 B | 9,790 | 20,396 | 95.84% |
+| `300MB` | 302,689,973 B | 29,233 | 60,916 | 95.83% |
+| `500MB` | 502,678,782 B | 48,676 | 101,442 | 95.82% |
+| `600MB` | 602,666,385 B | 58,466 | 121,848 | 95.82% |
+| `001GB` | 1,002,677,454 B | 97,499 | 203,200 | 95.82% |
+| `total_4GB` | 4,002,669,404 B | 390,302 | 813,452 | 95.81% |
+
+The larger variants contain the content represented by the smaller variants, allowing different training scales without requiring manual concatenation.
+
+---
+
+# Specialization
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 335" width="100%">
+  <rect width="1200" height="335" rx="20"
+        fill="#08080d"
+        stroke="#27272a"/>
+
+  <text x="600" y="43"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="16"
+        font-weight="700"
+        fill="#e2e8f0">
+    OBSIDIAN SPECIALIZATION
+  </text>
+
+  <g font-family="monospace" font-size="13">
+
+    <text x="85" y="95" fill="#94a3b8">Three.js</text>
+    <rect x="245" y="78" width="780" height="22" rx="11" fill="#18181b"/>
+    <rect x="245" y="78" width="755" height="22" rx="11" fill="#7c3aed"/>
+    <text x="1060" y="95" fill="#c4b5fd">CORE</text>
+
+    <text x="85" y="140" fill="#94a3b8">JavaScript</text>
+    <rect x="245" y="123" width="780" height="22" rx="11" fill="#18181b"/>
+    <rect x="245" y="123" width="740" height="22" rx="11" fill="#a21caf"/>
+    <text x="1060" y="140" fill="#f0abfc">HIGH</text>
+
+    <text x="85" y="185" fill="#94a3b8">HTML / CSS</text>
+    <rect x="245" y="168" width="780" height="22" rx="11" fill="#18181b"/>
+    <rect x="245" y="168" width="720" height="22" rx="11" fill="#2563eb"/>
+    <text x="1060" y="185" fill="#93c5fd">HIGH</text>
+
+    <text x="85" y="230" fill="#94a3b8">Canvas</text>
+    <rect x="245" y="213" width="780" height="22" rx="11" fill="#18181b"/>
+    <rect x="245" y="213" width="680" height="22" rx="11" fill="#0891b2"/>
+    <text x="1060" y="230" fill="#67e8f9">HIGH</text>
+
+    <text x="85" y="275" fill="#94a3b8">Python</text>
+    <rect x="245" y="258" width="780" height="22" rx="11" fill="#18181b"/>
+    <rect x="245" y="258" width="610" height="22" rx="11" fill="#4f46e5"/>
+    <text x="1060" y="275" fill="#a5b4fc">STRONG</text>
+
+  </g>
+</svg>
+
+</div>
+
+## Three.js
+
+Three.js is one of the primary specialization targets of OBSIDIAN.
+
+Training examples include patterns involving:
+
+- Scene creation
+- Perspective cameras
+- Lighting
+- Meshes
+- Materials
+- Geometry
+- Animation loops
+- Browser interaction
+- Keyboard input
+- Game mechanics
+- 3D environments
+- Interactive simulations
+- Single-file applications
+
+The goal is to teach the model to connect all required pieces of a Three.js application rather than merely outputting isolated API examples.
+
+---
+
+## Frontend Generation
+
+The model has strong exposure to complete frontend applications combining:
+
+```text
+HTML
+  │
+  ├── CSS
+  │
+  └── JavaScript
+        │
+        ├── DOM
+        ├── State
+        ├── Events
+        ├── Canvas
+        ├── Three.js
+        └── Animation
+```
+
+A typical training target may contain an entire application:
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        /* Complete interface */
+    </style>
+</head>
+
+<body>
+    <main>
+        <!-- Complete application -->
+    </main>
+
+    <script>
+        // State
+        // Logic
+        // Rendering
+        // Interaction
+        // Animation loop
+    </script>
+</body>
+</html>
+```
+
+---
+
+# Multilingual Programming
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 180" width="100%">
+  <rect width="1200" height="180" rx="18"
+        fill="#09090e"
+        stroke="#27272a"/>
+
+  <text x="600" y="38"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="15"
+        font-weight="700"
+        fill="#a78bfa">
+    MULTILINGUAL CODE INSTRUCTIONS
+  </text>
+
+  <g font-family="monospace"
+     font-size="14"
+     text-anchor="middle">
+
+    <g transform="translate(55,70)">
+      <rect width="100" height="42" rx="10" fill="#18121f" stroke="#7c3aed"/>
+      <text x="50" y="26" fill="#ddd6fe">PT</text>
+    </g>
+
+    <g transform="translate(165,70)">
+      <rect width="100" height="42" rx="10" fill="#18121f" stroke="#8b5cf6"/>
+      <text x="50" y="26" fill="#ddd6fe">EN</text>
+    </g>
+
+    <g transform="translate(275,70)">
+      <rect width="100" height="42" rx="10" fill="#18121f" stroke="#a855f7"/>
+      <text x="50" y="26" fill="#e9d5ff">ES</text>
+    </g>
+
+    <g transform="translate(385,70)">
+      <rect width="100" height="42" rx="10" fill="#19111e" stroke="#c026d3"/>
+      <text x="50" y="26" fill="#f5d0fe">FR</text>
+    </g>
+
+    <g transform="translate(495,70)">
+      <rect width="100" height="42" rx="10" fill="#19111e" stroke="#db2777"/>
+      <text x="50" y="26" fill="#fbcfe8">DE</text>
+    </g>
+
+    <g transform="translate(605,70)">
+      <rect width="100" height="42" rx="10" fill="#10131f" stroke="#2563eb"/>
+      <text x="50" y="26" fill="#bfdbfe">IT</text>
+    </g>
+
+    <g transform="translate(715,70)">
+      <rect width="100" height="42" rx="10" fill="#0c151c" stroke="#0284c7"/>
+      <text x="50" y="26" fill="#bae6fd">JA</text>
+    </g>
+
+    <g transform="translate(825,70)">
+      <rect width="100" height="42" rx="10" fill="#0c1519" stroke="#0891b2"/>
+      <text x="50" y="26" fill="#a5f3fc">ZH</text>
+    </g>
+
+    <g transform="translate(935,70)">
+      <rect width="100" height="42" rx="10" fill="#0c1718" stroke="#0d9488"/>
+      <text x="50" y="26" fill="#99f6e4">RU</text>
+    </g>
+
+    <g transform="translate(1045,70)">
+      <rect width="100" height="42" rx="10" fill="#0c1715" stroke="#10b981"/>
+      <text x="50" y="26" fill="#a7f3d0">TR</text>
+    </g>
+
+  </g>
+
+  <text x="600" y="148"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="11"
+        fill="#52525b">
+    10-LANGUAGE PROMPT MATRIX
+  </text>
+</svg>
+
+</div>
+
+The training corpus contains programming instructions across:
+
+| Language | Code |
+|---|---|
+| Português | `pt` |
+| English | `en` |
+| Español | `es` |
+| Français | `fr` |
+| Deutsch | `de` |
+| Italiano | `it` |
+| 日本語 | `ja` |
+| 简体中文 | `zh` |
+| Русский | `ru` |
+| Türkçe | `tr` |
+
+---
+
+# Fine-Tuning
+
+OBSIDIAN-9B-Coder was produced using supervised fine-tuning with **LoRA**.
+
+The training setup used for the model included:
+
+```text
+Training method          LoRA
+Precision                BF16
+LoRA rank                16
+LoRA alpha               32
+LoRA dropout             0
+Context target           32,768
+Trainer                  Unsloth
+Optimizer                AdamW BNB 8-bit
+Scheduler                Cosine
+Batch size               1
+Gradient accumulation    1
+Response-only training   Enabled
+```
+
+LoRA target modules:
+
+```text
+q_proj
+k_proj
+v_proj
+o_proj
+gate_proj
+up_proj
+down_proj
+```
+
+---
+
+# Example Prompts
+
+### Three.js
+
+```text
+Create a complete Three.js game inside a single HTML file.
+
+Include:
+- responsive rendering;
+- perspective camera;
+- dynamic lighting;
+- keyboard controls;
+- collision logic;
+- score system;
+- restart functionality;
+- animation loop.
+
+Return the complete HTML file.
+```
+
+### Portuguese
+
+```text
+Crie uma aplicação web completa usando HTML, CSS e JavaScript.
+
+A aplicação deve possuir uma interface moderna, animações,
+estado interno e interação com o usuário.
+
+Retorne o arquivo HTML completo.
+```
+
+### Canvas
+
+```text
+Build a complete interactive particle simulation using the
+HTML5 Canvas API.
+
+Include mouse interaction, animation, responsive resizing
+and performance-conscious rendering.
+```
+
+---
+
+# Recommended Generation
+
+Coding tasks generally benefit from conservative sampling.
+
+A reasonable starting point is:
+
+```text
+temperature: 0.2
+top_p: 0.9
+```
+
+For creative frontend generation:
+
+```text
+temperature: 0.5 - 0.7
+top_p: 0.9 - 0.95
+```
+
+These values are starting points rather than guarantees. Generation settings should be benchmarked for the target workload.
+
+---
+
+# Limitations
+
+OBSIDIAN-9B-Coder is a generative model.
+
+Generated code can contain:
+
+- logical errors;
+- security vulnerabilities;
+- hallucinated APIs;
+- outdated library usage;
+- incomplete edge-case handling;
+- incorrect assumptions;
+- dependency incompatibilities.
+
+Generated applications should be inspected and tested before production deployment.
+
+The model's context capacity also does not guarantee perfect reasoning or perfect retention across every token in a long context.
+
+---
+
+# Evaluation Recommendations
+
+For coding models such as OBSIDIAN, executable evaluation is strongly recommended.
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 210" width="100%">
+  <rect width="1200" height="210" rx="18"
+        fill="#08080c"
+        stroke="#27272a"/>
+
+  <text x="600" y="38"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="15"
+        font-weight="700"
+        fill="#c4b5fd">
+    CODE EVALUATION PIPELINE
+  </text>
+
+  <g font-family="monospace"
+     font-size="12"
+     text-anchor="middle">
+
+    <rect x="50" y="85" width="170" height="55" rx="12"
+          fill="#130d1c"
+          stroke="#7c3aed"/>
+    <text x="135" y="118" fill="#ddd6fe">GENERATE</text>
+
+    <text x="250" y="118" fill="#7c3aed">→</text>
+
+    <rect x="280" y="85" width="170" height="55" rx="12"
+          fill="#160d18"
+          stroke="#c026d3"/>
+    <text x="365" y="118" fill="#f5d0fe">PARSE</text>
+
+    <text x="480" y="118" fill="#c026d3">→</text>
+
+    <rect x="510" y="85" width="170" height="55" rx="12"
+          fill="#10121b"
+          stroke="#2563eb"/>
+    <text x="595" y="118" fill="#bfdbfe">EXECUTE</text>
+
+    <text x="710" y="118" fill="#2563eb">→</text>
+
+    <rect x="740" y="85" width="170" height="55" rx="12"
+          fill="#08151a"
+          stroke="#0891b2"/>
+    <text x="825" y="118" fill="#a5f3fc">INSPECT</text>
+
+    <text x="940" y="118" fill="#0891b2">→</text>
+
+    <rect x="970" y="85" width="180" height="55" rx="12"
+          fill="#091712"
+          stroke="#10b981"/>
+    <text x="1060" y="118" fill="#a7f3d0">TEST</text>
+
+  </g>
+
+  <text x="600" y="177"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="11"
+        fill="#52525b">
+    EXECUTION MATTERS MORE THAN TEXT SIMILARITY
+  </text>
+</svg>
+
+</div>
+
+Useful evaluation categories include:
+
+- HTML completeness
+- CSS validity
+- JavaScript syntax
+- Three.js initialization
+- Rendering-loop correctness
+- DOM interaction
+- Canvas rendering
+- Python syntax
+- Algorithmic correctness
+- Long-response completion
+- Multilingual instruction following
+
+---
+
+# Dataset Integrity
+
+Coder Max includes metadata intended to support corpus integrity and provenance tracking.
+
+Dataset preparation includes:
+
+- syntax-oriented filtering;
+- preservation of complete code;
+- credential and runtime artifact sanitization;
+- SHA-256 provenance metadata;
+- multilingual prompt labeling;
+- frontend classification metadata.
+
+Some repetitions in the dataset may be intentional and used to reinforce selected programming patterns and technologies.
+
+---
+
+# Base Model
+
+OBSIDIAN-9B-Coder is a **fine-tuned derivative model**.
+
+The underlying pretrained capabilities and architecture originate from the declared base model.
+
+OBSIDIAN should therefore not be interpreted as a foundation model trained from scratch.
+
+Users redistributing or deploying the model should review the licensing and usage requirements of the underlying model and training data.
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 300" width="100%">
+  <defs>
+    <radialGradient id="finalGlow">
+      <stop offset="0%" stop-color="#8b5cf6" stop-opacity="0.45"/>
+      <stop offset="100%" stop-color="#8b5cf6" stop-opacity="0"/>
+    </radialGradient>
+
+    <linearGradient id="finalBlade" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#c4b5fd"/>
+      <stop offset="50%" stop-color="#8b5cf6"/>
+      <stop offset="100%" stop-color="#22d3ee"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="1200" height="300" rx="20"
+        fill="#060609"/>
+
+  <circle cx="600" cy="135"
+          r="130"
+          fill="url(#finalGlow)"/>
+
+  <path d="M600 25 L685 80 L655 195 L600 245 L545 195 L515 80 Z"
+        fill="#0d0913"
+        stroke="url(#finalBlade)"
+        stroke-width="3"/>
+
+  <path d="M600 50 L645 95 L625 180 L600 215 L575 180 L555 95 Z"
+        fill="#151020"
+        stroke="#22d3ee"
+        stroke-opacity="0.6"/>
+
+  <path d="M600 70 L619 118 L600 190 L581 118 Z"
+        fill="url(#finalBlade)"/>
+
+  <text x="600" y="278"
+        text-anchor="middle"
+        font-family="monospace"
+        font-size="13"
+        font-weight="700"
+        fill="#64748b">
+    OBSIDIAN // FORGED FOR CODE
+  </text>
+</svg>
+
+</div>
+
+# Author
+
+**guell00**
+
+**Model:** OBSIDIAN-9B-Coder  
+**Dataset:** Coder Max Multilingual
+
+---
+
+<div align="center">
+
+## OBSIDIAN-9B-Coder
+
+**Complete Code • Long Context • Interactive Software**
+
+`Three.js` • `JavaScript` • `HTML` • `CSS` • `Canvas` • `Python` • `Multilingual`
+
+</div>