Update README.md

README.md

@@ -1,3 +1,859 @@
 ---
-license: mit
+pretty_name: OBSIDIAN-9B-Coder
+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:
+  - qwen
+  - qwen3.5
+  - coder
+  - code-generation
+  - programming
+  - frontend
+  - javascript
+  - html
+  - css
+  - threejs
+  - canvas
+  - python
+  - multilingual
+  - sft
+  - lora
+  - unsloth
 ---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1400 460" width="100%">
+  <defs>
+    <linearGradient id="obsidian-bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#050509"/>
+      <stop offset="40%" stop-color="#0d0b16"/>
+      <stop offset="75%" stop-color="#151020"/>
+      <stop offset="100%" stop-color="#05080c"/>
+    </linearGradient>
+
+```
+<linearGradient id="obsidian-main" x1="0" y1="0" x2="1" y2="0">
+  <stop offset="0%" stop-color="#7c3aed"/>
+  <stop offset="35%" stop-color="#c026d3"/>
+  <stop offset="70%" stop-color="#2563eb"/>
+  <stop offset="100%" stop-color="#06b6d4"/>
+</linearGradient>
+
+<linearGradient id="blade" x1="0" y1="0" x2="1" y2="1">
+  <stop offset="0%" stop-color="#d8b4fe"/>
+  <stop offset="45%" stop-color="#8b5cf6"/>
+  <stop offset="100%" stop-color="#22d3ee"/>
+</linearGradient>
+
+<filter id="glow">
+  <feGaussianBlur stdDeviation="8" result="blur"/>
+  <feMerge>
+    <feMergeNode in="blur"/>
+    <feMergeNode in="SourceGraphic"/>
+  </feMerge>
+</filter>
+
+<filter id="soft-glow">
+  <feGaussianBlur stdDeviation="3" result="blur"/>
+  <feMerge>
+    <feMergeNode in="blur"/>
+    <feMergeNode in="SourceGraphic"/>
+  </feMerge>
+</filter>
+```
+
+  </defs>
+
+  <rect width="1400" height="460" rx="26" fill="url(#obsidian-bg)"/>
+
+  <g opacity="0.07" stroke="#a78bfa" stroke-width="1">
+    <path d="M0 92H1400 M0 184H1400 M0 276H1400 M0 368H1400"/>
+    <path d="M175 0V460 M350 0V460 M525 0V460 M700 0V460 M875 0V460 M1050 0V460 M1225 0V460"/>
+  </g>
+
+  <circle cx="1170" cy="90" r="170" fill="#7c3aed" opacity="0.07"/>
+  <circle cx="1280" cy="330" r="210" fill="#0891b2" opacity="0.06"/>
+  <circle cx="180" cy="370" r="180" fill="#c026d3" opacity="0.05"/>
+
+<rect x="3" y="3" width="1394" height="454" rx="23"
+     fill="none" stroke="url(#obsidian-main)" stroke-width="2" opacity="0.45"/>
+
+  <!-- Obsidian symbol -->
+
+  <g transform="translate(100,95)" filter="url(#glow)">
+    <path d="M105 0 L190 65 L162 190 L105 240 L48 190 L20 65 Z"
+          fill="#0b0714" stroke="url(#blade)" stroke-width="4"/>
+    <path d="M105 25 L155 78 L135 165 L105 205 L75 165 L55 78 Z"
+          fill="#151021" stroke="#8b5cf6" stroke-width="2"/>
+    <path d="M105 48 L125 102 L105 172 L85 102 Z"
+          fill="url(#blade)" opacity="0.9"/>
+    <path d="M105 48 L105 172" stroke="#e9d5ff" stroke-width="2" opacity="0.7"/>
+  </g>
+
+<text x="360" y="145"
+     font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif"
+     font-size="69" font-weight="900"
+     fill="url(#obsidian-main)"
+     letter-spacing="4">
+OBSIDIAN </text>
+
+<text x="365" y="202"
+     font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif"
+     font-size="33" font-weight="800"
+     fill="#e2e8f0"
+     letter-spacing="7">
+9B CODER </text>
+
+<text x="365" y="249"
+     font-family="monospace"
+     font-size="18"
+     fill="#94a3b8">
+QWEN-BASED • MULTILINGUAL • FRONTEND SPECIALIZED </text>
+
+  <g transform="translate(365,285)">
+    <rect width="170" height="34" rx="17" fill="#7c3aed" fill-opacity="0.18" stroke="#8b5cf6" stroke-opacity="0.35"/>
+    <text x="85" y="22" text-anchor="middle" font-family="monospace" font-size="13" font-weight="700" fill="#c4b5fd">THREE.JS</text>
+
+```
+<rect x="185" width="170" height="34" rx="17" fill="#0891b2" fill-opacity="0.16" stroke="#22d3ee" stroke-opacity="0.35"/>
+<text x="270" y="22" text-anchor="middle" font-family="monospace" font-size="13" font-weight="700" fill="#67e8f9">HTML / JS</text>
+
+<rect x="370" width="170" height="34" rx="17" fill="#c026d3" fill-opacity="0.15" stroke="#e879f9" stroke-opacity="0.35"/>
+<text x="455" y="22" text-anchor="middle" font-family="monospace" font-size="13" font-weight="700" fill="#f0abfc">CANVAS</text>
+
+<rect x="555" width="170" height="34" rx="17" fill="#2563eb" fill-opacity="0.15" stroke="#60a5fa" stroke-opacity="0.35"/>
+<text x="640" y="22" text-anchor="middle" font-family="monospace" font-size="13" font-weight="700" fill="#93c5fd">PYTHON</text>
+```
+
+  </g>
+
+<text x="365" y="374"
+     font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif"
+     font-size="16" font-weight="600"
+     fill="#64748b"
+     letter-spacing="1">
+BUILT FROM CODE. TRAINED FOR COMPLETE SOFTWARE. </text>
+
+<text x="365" y="405"
+     font-family="monospace"
+     font-size="14"
+     fill="#475569">
+Coder Max × Qwen × Unsloth </text> </svg>
+
+</div>
+
+<br>
+
+<div align="center">
+
+**A 9B coding model specialized in complete software generation, modern frontend development, Three.js, Canvas and multilingual programming instructions.**
+
+</div>
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 118" width="100%">
+  <defs>
+    <linearGradient id="stats-bg" x1="0" x2="1">
+      <stop offset="0%" stop-color="#09070f"/>
+      <stop offset="50%" stop-color="#100b1a"/>
+      <stop offset="100%" stop-color="#071014"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="1200" height="118" rx="18" fill="url(#stats-bg)" stroke="#312e81" stroke-opacity="0.5"/>
+
+  <g font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif" text-anchor="middle">
+    <text x="120" y="46" font-size="27" font-weight="900" fill="#c4b5fd">9B</text>
+    <text x="120" y="76" font-size="12" fill="#64748b">PARAMETER CLASS</text>
+
+```
+<text x="360" y="46" font-size="27" font-weight="900" fill="#67e8f9">32K</text>
+<text x="360" y="76" font-size="12" fill="#64748b">SFT CONTEXT TARGET</text>
+
+<text x="600" y="46" font-size="27" font-weight="900" fill="#f0abfc">10</text>
+<text x="600" y="76" font-size="12" fill="#64748b">PROMPT LANGUAGES</text>
+
+<text x="840" y="46" font-size="27" font-weight="900" fill="#93c5fd">LoRA</text>
+<text x="840" y="76" font-size="12" fill="#64748b">SUPERVISED FINE-TUNING</text>
+
+<text x="1080" y="46" font-size="27" font-weight="900" fill="#86efac">95%+</text>
+<text x="1080" y="76" font-size="12" fill="#64748b">CODE-DENSE CORPUS</text>
+```
+
+  </g>
+</svg>
+
+</div>
+
+# OBSIDIAN-9B-Coder
+
+**OBSIDIAN-9B-Coder** is a Qwen-family coding model fine-tuned on the **Coder Max Multilingual** dataset by **guell00**.
+
+The model is designed around one primary objective:
+
+> **Generate complete software instead of merely discussing how to generate it.**
+
+Its specialization is concentrated on full-length programming outputs, particularly:
+
+* complete single-file web applications;
+* HTML5, CSS3 and modern JavaScript;
+* Three.js scenes and interactive 3D applications;
+* HTML5 Canvas applications;
+* frontend state and event handling;
+* browser graphics and animation loops;
+* Python and algorithmic programming;
+* multilingual coding instructions.
+
+OBSIDIAN is intended to favor **complete implementations**, including long frontend responses where closing tags, rendering loops, state management and application lifecycle matter.
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 260" width="100%">
+  <defs>
+    <linearGradient id="arch-bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#07070b"/>
+      <stop offset="100%" stop-color="#100c18"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="1200" height="260" rx="20" fill="url(#arch-bg)" stroke="#27272a"/>
+
+<text x="600" y="42" text-anchor="middle"
+     font-family="monospace" font-size="16" font-weight="700" fill="#a78bfa">
+OBSIDIAN TRAINING PIPELINE </text>
+
+  <g font-family="monospace" font-size="14" text-anchor="middle">
+    <rect x="55" y="90" width="190" height="78" rx="12" fill="#11101a" stroke="#475569"/>
+    <text x="150" y="120" fill="#e2e8f0">QWEN FAMILY</text>
+    <text x="150" y="145" fill="#64748b">9B FOUNDATION</text>
+
+```
+<path d="M245 129H320" stroke="#7c3aed" stroke-width="3"/>
+<path d="M310 121L320 129L310 137" fill="none" stroke="#7c3aed" stroke-width="3"/>
+
+<rect x="320" y="90" width="220" height="78" rx="12" fill="#120c19" stroke="#7c3aed"/>
+<text x="430" y="120" fill="#c4b5fd">CODER MAX</text>
+<text x="430" y="145" fill="#64748b">MULTILINGUAL CODE SFT</text>
+
+<path d="M540 129H615" stroke="#c026d3" stroke-width="3"/>
+<path d="M605 121L615 129L605 137" fill="none" stroke="#c026d3" stroke-width="3"/>
+
+<rect x="615" y="90" width="220" height="78" rx="12" fill="#0d111b" stroke="#2563eb"/>
+<text x="725" y="120" fill="#93c5fd">UNSLOTH LoRA</text>
+<text x="725" y="145" fill="#64748b">BF16 • LONG CONTEXT</text>
+
+<path d="M835 129H910" stroke="#0891b2" stroke-width="3"/>
+<path d="M900 121L910 129L900 137" fill="none" stroke="#0891b2" stroke-width="3"/>
+
+<rect x="910" y="90" width="235" height="78" rx="12" fill="#071419" stroke="#0891b2"/>
+<text x="1027" y="120" fill="#67e8f9">OBSIDIAN-9B</text>
+<text x="1027" y="145" fill="#64748b">CODE SPECIALIST</text>
+```
+
+  </g>
+
+<text x="600" y="220" text-anchor="middle"
+     font-family="monospace" font-size="12" fill="#475569">
+FOUNDATION → CURATED CODE → SUPERVISED SPECIALIZATION → COMPLETE SOFTWARE </text> </svg>
+
+</div>
+
+## Core Specialization
+
+OBSIDIAN is particularly focused on frontend code generation.
+
+### Three.js
+
+The training corpus contains intentional high-value exposure to Three.js code, including:
+
+* complete scenes;
+* cameras and controls;
+* lighting systems;
+* animated objects;
+* 3D games;
+* browser-based simulations;
+* meshes and materials;
+* render loops;
+* interactive environments;
+* single-file Three.js applications.
+
+The goal is not merely to recognize the Three.js API, but to generate coherent applications where scene initialization, rendering and interaction work together.
+
+### Complete Frontend Applications
+
+OBSIDIAN is trained on full application outputs rather than exclusively on isolated snippets.
+
+Typical targets include:
+
+```text
+<!DOCTYPE html>
+<html>
+    <head>
+        styles
+    </head>
+
+    <body>
+        interface
+
+        <script>
+            state
+            logic
+            rendering
+            interaction
+            animation
+        </script>
+    </body>
+</html>
+```
+
+This structure encourages the model to preserve application-level context from beginning to end.
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 330" width="100%">
+  <rect width="1200" height="330" rx="20" fill="#08080d" stroke="#27272a"/>
+
+<text x="600" y="43" text-anchor="middle"
+     font-family="monospace" font-size="17" font-weight="700" fill="#e2e8f0">
+SPECIALIZATION MATRIX </text>
+
+  <g font-family="monospace" font-size="13">
+
+```
+<text x="90" y="95" fill="#94a3b8">HTML / CSS</text>
+<rect x="260" y="77" width="790" height="22" rx="11" fill="#18181b"/>
+<rect x="260" y="77" width="750" height="22" rx="11" fill="#7c3aed"/>
+<text x="1080" y="94" fill="#c4b5fd">HIGH</text>
+
+<text x="90" y="140" fill="#94a3b8">JavaScript</text>
+<rect x="260" y="122" width="790" height="22" rx="11" fill="#18181b"/>
+<rect x="260" y="122" width="755" height="22" rx="11" fill="#a21caf"/>
+<text x="1080" y="139" fill="#f0abfc">HIGH</text>
+
+<text x="90" y="185" fill="#94a3b8">Three.js</text>
+<rect x="260" y="167" width="790" height="22" rx="11" fill="#18181b"/>
+<rect x="260" y="167" width="770" height="22" rx="11" fill="#0891b2"/>
+<text x="1080" y="184" fill="#67e8f9">CORE</text>
+
+<text x="90" y="230" fill="#94a3b8">Canvas 2D</text>
+<rect x="260" y="212" width="790" height="22" rx="11" fill="#18181b"/>
+<rect x="260" y="212" width="700" height="22" rx="11" fill="#2563eb"/>
+<text x="1080" y="229" fill="#93c5fd">HIGH</text>
+
+<text x="90" y="275" fill="#94a3b8">Python / Logic</text>
+<rect x="260" y="257" width="790" height="22" rx="11" fill="#18181b"/>
+<rect x="260" y="257" width="625" height="22" rx="11" fill="#4f46e5"/>
+<text x="1080" y="274" fill="#a5b4fc">STRONG</text>
+```
+
+  </g>
+</svg>
+
+</div>
+
+## Training Dataset
+
+OBSIDIAN is fine-tuned on:
+
+**[`guell00/Coder-max`](https://huggingface.co/datasets/guell00/Coder-max)**
+
+Coder Max Multilingual is a code-dense conversational SFT corpus built around complete programming responses.
+
+Major properties of the full dataset include:
+
+| Property                |                 Value |
+| ----------------------- | --------------------: |
+| Languages               |                    10 |
+| Largest corpus          |                 ~4 GB |
+| Records                 |                 ~390K |
+| Messages                |                 ~813K |
+| Code density            |                ~95.8% |
+| Format                  | JSONL / chat messages |
+| Primary focus           |       Code generation |
+| Frontend specialization |                  High |
+
+The corpus includes incremental dataset variants ranging from compact experimental subsets to the complete multi-gigabyte distribution.
+
+---
+
+## Multilingual Support
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 190" width="100%">
+  <rect width="1200" height="190" rx="18" fill="#09090e" stroke="#27272a"/>
+
+<text x="600" y="40" text-anchor="middle"
+     font-family="monospace" font-size="15" font-weight="700" fill="#a78bfa">
+10-LANGUAGE INSTRUCTION MATRIX </text>
+
+  <g font-family="monospace" font-size="14" text-anchor="middle">
+
+```
+<g transform="translate(65,75)">
+  <rect width="100" height="42" rx="10" fill="#18121f" stroke="#7c3aed"/>
+  <text x="50" y="26" fill="#ddd6fe">PT</text>
+</g>
+
+<g transform="translate(175,75)">
+  <rect width="100" height="42" rx="10" fill="#18121f" stroke="#8b5cf6"/>
+  <text x="50" y="26" fill="#ddd6fe">EN</text>
+</g>
+
+<g transform="translate(285,75)">
+  <rect width="100" height="42" rx="10" fill="#18121f" stroke="#a855f7"/>
+  <text x="50" y="26" fill="#e9d5ff">ES</text>
+</g>
+
+<g transform="translate(395,75)">
+  <rect width="100" height="42" rx="10" fill="#19111e" stroke="#c026d3"/>
+  <text x="50" y="26" fill="#f5d0fe">FR</text>
+</g>
+
+<g transform="translate(505,75)">
+  <rect width="100" height="42" rx="10" fill="#19111e" stroke="#db2777"/>
+  <text x="50" y="26" fill="#fbcfe8">DE</text>
+</g>
+
+<g transform="translate(615,75)">
+  <rect width="100" height="42" rx="10" fill="#10131f" stroke="#2563eb"/>
+  <text x="50" y="26" fill="#bfdbfe">IT</text>
+</g>
+
+<g transform="translate(725,75)">
+  <rect width="100" height="42" rx="10" fill="#0c151c" stroke="#0284c7"/>
+  <text x="50" y="26" fill="#bae6fd">JA</text>
+</g>
+
+<g transform="translate(835,75)">
+  <rect width="100" height="42" rx="10" fill="#0c1519" stroke="#0891b2"/>
+  <text x="50" y="26" fill="#a5f3fc">ZH</text>
+</g>
+
+<g transform="translate(945,75)">
+  <rect width="100" height="42" rx="10" fill="#0c1718" stroke="#0d9488"/>
+  <text x="50" y="26" fill="#99f6e4">RU</text>
+</g>
+
+<g transform="translate(1055,75)">
+  <rect width="80" height="42" rx="10" fill="#0c1715" stroke="#10b981"/>
+  <text x="40" y="26" fill="#a7f3d0">TR</text>
+</g>
+```
+
+  </g>
+
+<text x="600" y="151" text-anchor="middle"
+     font-family="monospace" font-size="11" fill="#52525b">
+PROGRAMMING INSTRUCTIONS ACROSS MULTIPLE HUMAN LANGUAGES </text> </svg>
+
+</div>
+
+Supported prompt languages include:
+
+| Language  | Code |
+| --------- | ---- |
+| Português | `pt` |
+| English   | `en` |
+| Español   | `es` |
+| Français  | `fr` |
+| Deutsch   | `de` |
+| Italiano  | `it` |
+| 日本語       | `ja` |
+| 简体中文      | `zh` |
+| Русский   | `ru` |
+| Türkçe    | `tr` |
+
+---
+
+## Intended Behavior
+
+OBSIDIAN is optimized toward requests such as:
+
+```text
+Create a complete Three.js game in one HTML file.
+```
+
+```text
+Crie uma aplicação web completa com HTML, CSS e JavaScript.
+```
+
+```text
+Build an interactive particle simulation using Canvas.
+```
+
+```text
+Create a complete Three.js scene with lighting, camera controls,
+animations and responsive UI.
+```
+
+```text
+Implement the entire solution. Do not omit code.
+```
+
+The fine-tuning objective favors responses that contain the **implementation itself** rather than lengthy preambles.
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 225" width="100%">
+  <defs>
+    <linearGradient id="flow" x1="0" x2="1">
+      <stop offset="0%" stop-color="#7c3aed"/>
+      <stop offset="50%" stop-color="#c026d3"/>
+      <stop offset="100%" stop-color="#0891b2"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="1200" height="225" rx="18" fill="#08080c" stroke="#27272a"/>
+
+<text x="600" y="40" text-anchor="middle"
+     font-family="monospace" font-size="15" fill="#c4b5fd" font-weight="700">
+GENERATION PHILOSOPHY </text>
+
+  <g font-family="monospace" text-anchor="middle">
+    <rect x="80" y="88" width="230" height="65" rx="14" fill="#130d1c" stroke="#7c3aed"/>
+    <text x="195" y="115" font-size="14" fill="#ddd6fe">USER INTENT</text>
+    <text x="195" y="137" font-size="11" fill="#64748b">natural language</text>
+
+```
+<path d="M310 120H445" stroke="url(#flow)" stroke-width="4"/>
+<path d="M432 110L445 120L432 130" fill="none" stroke="#c026d3" stroke-width="4"/>
+
+<rect x="445" y="88" width="310" height="65" rx="14" fill="#160d18" stroke="#c026d3"/>
+<text x="600" y="115" font-size="14" fill="#f5d0fe">OBSIDIAN-9B-CODER</text>
+<text x="600" y="137" font-size="11" fill="#64748b">reason + construct</text>
+
+<path d="M755 120H890" stroke="url(#flow)" stroke-width="4"/>
+<path d="M877 110L890 120L877 130" fill="none" stroke="#0891b2" stroke-width="4"/>
+
+<rect x="890" y="88" width="230" height="65" rx="14" fill="#07171b" stroke="#0891b2"/>
+<text x="1005" y="115" font-size="14" fill="#a5f3fc">COMPLETE CODE</text>
+<text x="1005" y="137" font-size="11" fill="#64748b">ready to inspect</text>
+```
+
+  </g>
+
+<text x="600" y="192" text-anchor="middle"
+     font-family="monospace" font-size="11" fill="#52525b">
+LESS TALK • MORE IMPLEMENTATION • COMPLETE OUTPUTS </text> </svg>
+
+</div>
+
+## Model Architecture & Fine-Tuning
+
+OBSIDIAN-9B-Coder is produced using parameter-efficient supervised fine-tuning.
+
+Training configuration for the initial OBSIDIAN experiments:
+
+```text
+Method                     LoRA
+Precision                  BF16
+LoRA Rank                  16
+LoRA Alpha                 32
+LoRA Dropout               0
+Context Target             32,768 tokens
+Trainer                    Unsloth
+Optimizer                  AdamW BNB 8-bit
+Scheduler                  Cosine
+Batch Size                 1
+Gradient Accumulation      1
+Response-only Loss         Enabled
+```
+
+Primary LoRA target modules:
+
+```text
+q_proj
+k_proj
+v_proj
+o_proj
+gate_proj
+up_proj
+down_proj
+```
+
+Only a small fraction of the model parameters are modified during LoRA training, preserving most capabilities of the underlying foundation model while specializing its behavior toward the Coder Max distribution.
+
+---
+
+## Recommended Inference
+
+For deterministic programming tasks, begin with relatively conservative sampling.
+
+Example conceptual settings:
+
+```python
+temperature = 0.2
+top_p = 0.9
+```
+
+For creative frontend or graphical generation, slightly higher sampling may produce more varied designs:
+
+```python
+temperature = 0.6
+top_p = 0.95
+```
+
+Exact settings should be benchmarked for the intended task.
+
+---
+
+## Example Prompt
+
+```text
+Create a complete single-file HTML application using Three.js.
+
+Requirements:
+- responsive layout;
+- perspective camera;
+- interactive controls;
+- dynamic lighting;
+- animated objects;
+- game state;
+- keyboard input;
+- score system;
+- restart functionality.
+
+Return the complete HTML file.
+```
+
+Expected OBSIDIAN behavior:
+
+```text
+<!DOCTYPE html>
+<html>
+<head>
+    ...
+</head>
+<body>
+    ...
+    <script>
+        // complete scene
+        // state
+        // input
+        // rendering
+        // game loop
+    </script>
+</body>
+</html>
+```
+
+---
+
+## What OBSIDIAN Is Not
+
+OBSIDIAN is not intended to guarantee that every generated program is:
+
+* secure;
+* bug-free;
+* production-ready;
+* dependency-compatible;
+* optimized;
+* factually correct.
+
+Code generation models can produce plausible but incorrect implementations.
+
+Generated software should be reviewed and tested before production deployment.
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 145" width="100%">
+  <rect width="1200" height="145" rx="18" fill="#09090d" stroke="#3f3f46"/>
+
+  <path d="M60 72H1140" stroke="#27272a"/>
+
+  <g font-family="monospace" text-anchor="middle">
+    <text x="190" y="60" font-size="20" font-weight="800" fill="#c4b5fd">BUILD</text>
+    <text x="190" y="91" font-size="11" fill="#52525b">COMPLETE SOFTWARE</text>
+
+```
+<text x="470" y="60" font-size="20" font-weight="800" fill="#f0abfc">RENDER</text>
+<text x="470" y="91" font-size="11" fill="#52525b">INTERACTIVE WORLDS</text>
+
+<text x="750" y="60" font-size="20" font-weight="800" fill="#93c5fd">THINK</text>
+<text x="750" y="91" font-size="11" fill="#52525b">PROGRAMMING LOGIC</text>
+
+<text x="1030" y="60" font-size="20" font-weight="800" fill="#67e8f9">SHIP</text>
+<text x="1030" y="91" font-size="11" fill="#52525b">FULL OUTPUTS</text>
+```
+
+  </g>
+</svg>
+
+</div>
+
+## Relationship to the Base Model
+
+OBSIDIAN-9B-Coder is a derivative fine-tune.
+
+The underlying architecture and pretrained capabilities originate from its declared base model.
+
+OBSIDIAN should therefore be understood as a **specialized coding derivative**, not as a newly pretrained foundation model.
+
+When redistributing or deploying OBSIDIAN, review the terms and license requirements of both:
+
+1. the underlying base model;
+2. the Coder Max training dataset.
+
+---
+
+## Dataset Integrity
+
+Coder Max uses SHA-256 metadata and provenance records to help validate training artifacts and identify intentional repetitions.
+
+Intentional repeated samples may be present as part of the dataset's specialization strategy.
+
+These samples are designed to reinforce selected programming behaviors and technologies rather than representing accidental duplicate ingestion.
+
+---
+
+## Limitations
+
+The model may:
+
+* reproduce patterns from its training corpus;
+* generate syntactically valid but logically incorrect code;
+* hallucinate browser or library APIs;
+* produce unsafe application logic;
+* generate outdated dependency usage;
+* fail on highly specialized technologies outside the training distribution.
+
+Long-context capability of the underlying architecture does not guarantee perfect long-range reasoning or error-free generation across the entire context window.
+
+---
+
+## Evaluation
+
+Recommended evaluation categories for OBSIDIAN include:
+
+```text
+HTML completeness
+CSS validity
+JavaScript syntax
+Three.js scene initialization
+Render-loop correctness
+DOM interaction
+Canvas rendering
+Python syntax
+Algorithmic correctness
+Multilingual instruction following
+Long-response completion
+```
+
+For frontend evaluation, executable browser-based benchmarks are more informative than text similarity alone.
+
+A generated application should ideally be:
+
+```text
+generated
+   ↓
+parsed
+   ↓
+executed
+   ↓
+inspected
+   ↓
+interaction-tested
+```
+
+---
+
+<div align="center">
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 300" width="100%">
+  <defs>
+    <radialGradient id="coreGlow">
+      <stop offset="0%" stop-color="#8b5cf6" stop-opacity="0.45"/>
+      <stop offset="100%" stop-color="#8b5cf6" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <rect width="1200" height="300" rx="20" fill="#060609"/>
+
+  <circle cx="600" cy="150" r="130" fill="url(#coreGlow)"/>
+
+<path d="M600 40 L685 95 L655 210 L600 260 L545 210 L515 95 Z"
+     fill="#0d0913"
+     stroke="#8b5cf6"
+     stroke-width="3"/>
+
+<path d="M600 65 L645 110 L625 195 L600 225 L575 195 L555 110 Z"
+     fill="#151020"
+     stroke="#22d3ee"
+     stroke-opacity="0.6"/>
+
+<path d="M600 86L619 133L600 202L581 133Z"
+     fill="#8b5cf6"/>
+
+<text x="600" y="280"
+     text-anchor="middle"
+     font-family="monospace"
+     font-size="13"
+     fill="#64748b">
+OBSIDIAN // FORGED FOR CODE </text> </svg>
+
+</div>
+
+## Author
+
+**guell00**
+
+Dataset:
+
+**Coder Max Multilingual**
+
+Model:
+
+**OBSIDIAN-9B-Coder**
+
+---
+
+## Citation
+
+If you use OBSIDIAN-9B-Coder in research or derivative work, please reference the model repository and the Coder Max dataset.
+
+```bibtex
+@misc{obsidian9bcoder,
+  title  = {OBSIDIAN-9B-Coder},
+  author = {guell00},
+  year   = {2026},
+  note   = {Qwen-based multilingual coding model fine-tuned on Coder Max}
+}
+```
+
+---
+
+<div align="center">
+
+### OBSIDIAN-9B-Coder
+
+**Complete code. Long context. Interactive software.**
+
+`HTML` • `CSS` • `JavaScript` • `Three.js` • `Canvas` • `Python` • `Multilingual`
+
+</div>