Team Ai
Modelpublic

guell00/OBSIDIAN-9B-Coder

sourceHugging Faceupdated 2mo agoView on Hugging Face
2likes827downloads
Model Card

๐Ÿ’Ž OBSIDIAN-9B-Coder

Complete Code ยท Long Context ยท Interactive Software

OBSIDIAN-9B-Coder is a 9B-class coding model fine-tuned from Jackrong/Qwopus3.5-9B-Coder using 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, Python and general programming.

OBSIDIAN is designed around a simple objective:

Generate the implementation, not fragments of it.

โšก Highlights

FeatureOBSIDIAN-9B-Coder
Model Class9B
Training Context32K
Training MethodLoRA SFT
Training FrameworkUnsloth
Languages10
Primary FocusCode Generation
FrontendStrong specialization
Three.jsStrong specialization
CanvasStrong specialization
JavaScriptStrong specialization
PythonSupported
DistributionGGUF

๐Ÿง  Overview

OBSIDIAN-9B-Coder was created to further specialize an already capable coding model toward implementation-heavy programming tasks.

Instead of focusing primarily on explanations surrounding code, the fine-tuning corpus heavily emphasizes generation of the actual implementation.

The model is particularly suited for:

  • โ€”Complete single-file web applications
  • โ€”HTML5
  • โ€”Modern CSS
  • โ€”JavaScript ES6+
  • โ€”Three.js
  • โ€”HTML5 Canvas
  • โ€”Interactive browser applications
  • โ€”Browser games
  • โ€”Graphical experiments
  • โ€”DOM manipulation
  • โ€”Animation loops
  • โ€”State management
  • โ€”Python
  • โ€”Algorithms
  • โ€”Multilingual programming instructions
  • โ€”Long-form code generation

๐Ÿ”ฅ Core Philosophy

text
USER REQUEST
      โ”‚
      โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  OBSIDIAN-9B-Coder   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
      โ”‚
      โ–ผ
COMPLETE IMPLEMENTATION
      โ”‚
      โ”œโ”€โ”€ HTML
      โ”œโ”€โ”€ CSS
      โ”œโ”€โ”€ JavaScript
      โ”œโ”€โ”€ Three.js
      โ”œโ”€โ”€ Canvas
      โ””โ”€โ”€ Python

The training strategy emphasizes:

text
Less boilerplate explanation
           +
More actual implementation
           +
Complete long-form outputs
           =
OBSIDIAN

OBSIDIAN is fine-tuned to preserve long application structures including:

  • โ€”document layout;
  • โ€”styles;
  • โ€”application state;
  • โ€”event handlers;
  • โ€”rendering logic;
  • โ€”animation loops;
  • โ€”user interaction;
  • โ€”game logic;
  • โ€”DOM lifecycle;
  • โ€”complete closing structures.

๐ŸŽฎ Three.js Specialization

Three.js is one of the primary specialization targets of OBSIDIAN.

Training examples contain patterns involving:

  • โ€”Scene creation
  • โ€”Perspective cameras
  • โ€”Lighting
  • โ€”Meshes
  • โ€”Materials
  • โ€”Geometry
  • โ€”Animation loops
  • โ€”Keyboard input
  • โ€”Mouse interaction
  • โ€”Game mechanics
  • โ€”Collision logic
  • โ€”3D environments
  • โ€”Interactive simulations
  • โ€”Complete browser games
  • โ€”Single-file Three.js applications

The objective is not simply to teach isolated Three.js API calls.

The model is trained to connect the different components required to produce an actual working application.

For example:

text
Scene
  โ”‚
  โ”œโ”€โ”€ Camera
  โ”œโ”€โ”€ Renderer
  โ”œโ”€โ”€ Lighting
  โ”œโ”€โ”€ Objects
  โ”‚
  โ””โ”€โ”€ Materials
  โ”‚
  โ”œโ”€โ”€ Input
  โ”œโ”€โ”€ State
  โ”œโ”€โ”€ Game Logic
  โ””โ”€โ”€ Animation Loop

๐ŸŒ Frontend Generation

OBSIDIAN has strong exposure to complete frontend applications combining:

text
HTML
 โ”‚
 โ”œโ”€โ”€ CSS
 โ”‚
 โ””โ”€โ”€ JavaScript
       โ”‚
       โ”œโ”€โ”€ DOM
       โ”œโ”€โ”€ State
       โ”œโ”€โ”€ Events
       โ”œโ”€โ”€ Canvas
       โ”œโ”€โ”€ Three.js
       โ”œโ”€โ”€ Rendering
       โ””โ”€โ”€ Animation

A typical training target may contain an entire application:

html
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">

    <style>
        /* Complete interface */
    </style>
</head>

<body>

    <main>
        <!-- Complete application -->
    </main>

    <script>
        // Application state

        // Event handling

        // Rendering

        // Interaction

        // Animation loop
    </script>

</body>
</html>

The objective is to reduce common failure modes where coding models generate the beginning of an application but fail to correctly complete its architecture.


๐ŸŒ Multilingual Programming

OBSIDIAN was fine-tuned with programming instructions across 10 languages.

LanguageCode
Portuguรชspt
Englishen
Espaรฑoles
Franรงaisfr
Deutschde
Italianoit
ๆ—ฅๆœฌ่ชžja
็ฎ€ไฝ“ไธญๆ–‡zh
ะ ัƒััะบะธะนru
Tรผrkรงetr

The goal is to make coding capability less dependent on the natural language used in the instruction.

A developer can therefore ask for implementations using prompts in multiple languages while still requesting code in the same programming ecosystem.


๐Ÿ—ƒ๏ธ Training Dataset

OBSIDIAN-9B-Coder was fine-tuned using Coder Max Multilingual.

Dataset:

guell00/Coder-max

Coder Max is a conversational supervised fine-tuning dataset focused heavily on code generation.

The corpus was designed around complete implementations rather than heavily truncated programming responses.

Dataset Characteristics

CharacteristicDescription
FormatJSONL
StructureConversational messages
Training TypeSupervised Fine-Tuning
Languages10
Main ContentProgramming
Code Density~95%+
Frontend FocusStrong
Three.js SpecializationStrong
Long Code OutputsPreserved

๐Ÿ“Š Coder Max Scale

Coder Max is distributed in multiple incremental variants.

VariantPhysical SizeRecordsMessagesCode Density
001MB3,739,874 B10922099.08%
010MB12,709,008 B9692,01296.18%
100MB102,679,666 B9,79020,39695.84%
300MB302,689,973 B29,23360,91695.83%
500MB502,678,782 B48,676101,44295.82%
600MB602,666,385 B58,466121,84895.82%
001GB1,002,677,454 B97,499203,20095.82%
total_4GB4,002,669,404 B390,302813,45295.81%

The larger variants contain the content represented by the smaller variants, allowing different training scales without requiring manual concatenation.


๐Ÿงน Dataset Curation

Coder Max was built with a code-oriented preprocessing pipeline.

Important characteristics include:

Code Density

More than 95% of the larger corpus variants consist of code-oriented content.

Python Syntax Validation

Python blocks were structurally checked during preprocessing.

Invalid or corrupted samples could therefore be removed before training.

Complete Code Preservation

Long HTML, CSS and JavaScript applications are preserved rather than intentionally truncated.

This is especially important for teaching:

  • โ€”closing tags;
  • โ€”application state;
  • โ€”complete functions;
  • โ€”event listeners;
  • โ€”rendering loops;
  • โ€”lifecycle logic.

Data Sanitization

The preprocessing pipeline targets removal of artifacts such as:

  • โ€”credentials;
  • โ€”API keys;
  • โ€”local IP addresses;
  • โ€”runtime artifacts.

Provenance

Dataset records include SHA-256-based provenance metadata.


๐Ÿงช Fine-Tuning

OBSIDIAN-9B-Coder was produced using supervised fine-tuning with LoRA.

Training configuration:

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
Response-only training   Enabled

LoRA target modules:

text
q_proj
k_proj
v_proj
o_proj
gate_proj
up_proj
down_proj

๐Ÿงฌ Training Strategy

The model was trained using a code-heavy SFT corpus designed around long-form completions.

Important characteristics include:

  • โ€”long HTML responses;
  • โ€”complete application generation;
  • โ€”high-value specialization examples;
  • โ€”multilingual prompt variants;
  • โ€”frontend-oriented training;
  • โ€”Three.js exposure;
  • โ€”Canvas exposure;
  • โ€”JavaScript-heavy examples;
  • โ€”assistant-response-only loss.

Some repetitions in the source dataset may be intentional.

Selected programming concepts and application patterns can be repeated to reinforce specific behaviors and specialization targets.


๐Ÿ“ฆ GGUF

OBSIDIAN-9B-Coder is distributed in GGUF format for efficient local inference.

Available quantizations include:

FileQuantizationRecommended Use
Qwopus3.5-9B-Coder.Q8_0.ggufQ8_0Maximum practical GGUF fidelity
Qwopus3.5-9B-Coder.Q6_K.ggufQ6_KHigh quality
Qwopus3.5-9B-Coder.Q5_K_M.ggufQ5KMQuality / size balance
Qwopus3.5-9B-Coder.Q4_K_M.ggufQ4KMRecommended general use
Qwopus3.5-9B-Coder.Q3_K_M.ggufQ3KMMemory-constrained systems
Qwopus3.5-9B-Coder.BF16-mmproj.ggufBF16 mmprojMultimodal projector

โš–๏ธ Quantization Guide

text
              QUALITY
                 โ–ฒ
                 โ”‚
Q8_0      โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
Q6_K      โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
Q5_K_M    โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
Q4_K_M    โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
Q3_K_M    โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ
                 โ”‚
                 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ LOWER MEMORY

Q8_0

Use when preserving model fidelity is more important than memory consumption.

Q6_K

High-quality option with lower requirements than Q8_0.

Q5KM

Strong compromise between model fidelity and memory requirements.

Q4KM

Recommended starting point for most local deployments.

Q3KM

Designed for systems where memory consumption is the primary constraint.

For coding workloads, Q4_K_M and Q5_K_M are good starting points.


๐Ÿš€ llama.cpp

For compatible text inference:

bash
llama-cli -hf guell00/OBSIDIAN-9B-Coder --jinja

For compatible multimodal inference:

bash
llama-mtmd-cli -hf guell00/OBSIDIAN-9B-Coder --jinja

The exact command and available features depend on the installed llama.cpp version and selected GGUF files.


๐Ÿ’ป Example Prompts

Three.js Game

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.

Frontend Application

text
Create a complete responsive web application using HTML,
CSS and vanilla JavaScript.

The application must include:

- modern interface;
- internal state;
- animations;
- user interaction;
- responsive design.

Return a single 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.

Python

text
Implement a complete Python solution for the following problem.

Explain the algorithm briefly and return working code.

๐ŸŽ›๏ธ Generation Settings

Coding tasks generally benefit from conservative sampling.

A reasonable starting point:

text
temperature: 0.2
top_p: 0.9

For more creative frontend generation:

text
temperature: 0.5 - 0.7
top_p: 0.9 - 0.95

These values are starting points rather than guaranteed optimal settings.

Generation parameters should be benchmarked for the target workload.


๐ŸŽฏ Intended Use

OBSIDIAN-9B-Coder is intended for:

  • โ€”Coding assistants
  • โ€”Frontend code generation
  • โ€”HTML/CSS/JavaScript generation
  • โ€”Three.js applications
  • โ€”Browser games
  • โ€”Canvas applications
  • โ€”Interactive interfaces
  • โ€”Python programming
  • โ€”Programming experiments
  • โ€”Multilingual coding assistants
  • โ€”Local coding models
  • โ€”Research into code-specialized fine-tuning

๐Ÿ“ Evaluation

Executable evaluation is strongly recommended for coding models.

A useful evaluation pipeline is:

text
PROMPT
  โ”‚
  โ–ผ
GENERATE
  โ”‚
  โ–ผ
PARSE
  โ”‚
  โ–ผ
EXECUTE
  โ”‚
  โ–ผ
INSPECT
  โ”‚
  โ–ผ
TEST

Useful evaluation categories include:

  • โ€”HTML completeness
  • โ€”CSS validity
  • โ€”JavaScript syntax
  • โ€”JavaScript runtime behavior
  • โ€”Three.js initialization
  • โ€”Rendering-loop correctness
  • โ€”DOM interaction
  • โ€”Canvas rendering
  • โ€”Python syntax
  • โ€”Algorithmic correctness
  • โ€”Long-response completion
  • โ€”Multilingual instruction following

For code-generation models, executable correctness is generally more informative than text similarity alone.


โš ๏ธ 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.

Long context capacity also does not guarantee perfect reasoning or perfect retention across every token of a long prompt.


๐Ÿงฌ Model Lineage

OBSIDIAN-9B-Coder was not trained from scratch.

Its lineage is:

text
Qwen3.5 family
       โ”‚
       โ–ผ
Jackrong/Qwopus3.5-9B-Coder
       โ”‚
       โ–ผ
Coder Max Multilingual
       โ”‚
       โ–ผ
LoRA Supervised Fine-Tuning
       โ”‚
       โ–ผ
OBSIDIAN-9B-Coder
       โ”‚
       โ–ผ
GGUF Quantizations

OBSIDIAN therefore inherits substantial pretrained and coding capabilities from its base model while adding specialization through Coder Max.


๐Ÿ“š Training Sources

Base Model

OBSIDIAN-9B-Coder was fine-tuned from:

Jackrong/Qwopus3.5-9B-Coder

Hugging Face:

https://huggingface.co/Jackrong/Qwopus3.5-9B-Coder

The Jackrong model is itself a coding-focused derivative of the Qwen3.5 model family and provides the underlying pretrained and coding capabilities used as the starting point for OBSIDIAN.


Fine-Tuning Dataset

The dataset used for the OBSIDIAN fine-tuning stage was:

Coder Max Multilingual

Author: guell00

Hugging Face:

https://huggingface.co/datasets/guell00/Coder-max

Coder Max provides the additional specialization toward:

  • โ€”complete code generation;
  • โ€”HTML/CSS/JavaScript;
  • โ€”Three.js;
  • โ€”Canvas;
  • โ€”Python;
  • โ€”interactive applications;
  • โ€”long-form implementations;
  • โ€”multilingual programming instructions.

๐Ÿ—๏ธ Training Stack

text
Qwen3.5 Model Family
        โ”‚
        โ–ผ
Jackrong/Qwopus3.5-9B-Coder
        โ”‚
        โ”‚  Base model
        โ–ผ
Coder Max Multilingual
guell00/Coder-max
        โ”‚
        โ”‚  Code-focused SFT data
        โ–ผ
LoRA + SFT
Unsloth
        โ”‚
        โ–ผ
OBSIDIAN-9B-Coder
        โ”‚
        โ–ผ
GGUF
        โ”‚
        โ”œโ”€โ”€ Q3_K_M
        โ”œโ”€โ”€ Q4_K_M
        โ”œโ”€โ”€ Q5_K_M
        โ”œโ”€โ”€ Q6_K
        โ””โ”€โ”€ Q8_0

๐Ÿ™ Credits

OBSIDIAN-9B-Coder builds upon work from the open-source model ecosystem.

Qwen

For the underlying Qwen model family and architecture.

Jackrong

For Qwopus3.5-9B-Coder, used as the direct base model for this fine-tuning.

Unsloth

For the efficient fine-tuning and model conversion tooling used during training.

guell00

For:

  • โ€”Coder Max Multilingual
  • โ€”OBSIDIAN fine-tuning
  • โ€”dataset preparation
  • โ€”model specialization
  • โ€”GGUF release

๐Ÿ’Ž OBSIDIAN-9B-Coder

text
Base
  Jackrong/Qwopus3.5-9B-Coder

        +

Dataset
  guell00/Coder-max

        +

Fine-Tuning
  LoRA SFT / Unsloth

        =

  OBSIDIAN-9B-Coder

9B ยท 32K Training Context ยท Three.js ยท JavaScript ยท HTML ยท CSS ยท Canvas ยท Python ยท Multilingual

OBSIDIAN-9B-Coder โ€” specialized for complete code generation.