mehdi commited on
Commit
a482822
·
verified ·
1 Parent(s): d777cff

Create README.md

Browse files

# Roblox-Coder

## / Project Overview

**Roblox_Coder** is a fine-tuned version of **Qwen 3.5 4B**, trained specifically for **Roblox Studio development and Luau programming**.

It is designed to act as a **Roblox backend + systems development assistant**, capable of generating structured, server-authoritative, and production-style Luau code for real Roblox game development workflows.

The model was trained on a curated instruction dataset focused on high-quality Roblox systems design, covering backend architecture, secure scripting patterns, and scalable game development workflows.

* Server-authoritative game architecture
* DataStore systems and persistence
* RemoteEvent / RemoteFunction networking
* Secure combat and anti-exploit patterns
* NPC AI and Pathfinding systems
* Inventory, shop, and progression systems
* UI frameworks and Roblox client systems
* Performance-aware Luau scripting patterns

---

## / Model Capabilities

This model is optimized for **Roblox systems engineering**, and performs best in backend-heavy development tasks.

### / Core Strengths

* Generates structured Luau systems (services, modules, frameworks)
* Strong understanding of **client-server separation**
* Produces secure **server-authoritative gameplay logic**
* Implements **DataStore-backed progression systems**
* Builds scalable **inventory, shop, and economy systems**
* Designs **NPC AI with PathfindingService**
* Handles **RemoteEvent validation and anti-exploit logic**
* Creates modular Roblox architecture patterns (Service-based design)

### / Advanced Behavior

* Enforces anti-exploit security by default in generated code
* Prefers scalable architecture over quick scripts
* Uses strict typing patterns where applicable (`--!strict`)
* Encourages server-side validation for all critical logic
* Produces production-style Luau structure rather than beginner scripts

### / Known Limitations

* Not optimized for animation, VFX, or art-heavy systems
* Limited knowledge of Studio UI/UX design workflows
* May over-engineer simple tasks into full systems
* Lower dataset size limits general Roblox coverage

---

## / System Requirements

This model can run locally in GGUF or quantized formats.

### / Model Sizes

| Quantization | Size | Recommended Use |
| ------------ | -------- | -------------------------------- |
| Q4_K_M | ~2.78 GB | Fast inference, low VRAM systems |
| Q5_K_M | ~3.16 GB | Balanced quality/performance |
| Q8_0 | ~4.61 GB | High quality inference |

---

### / Hardware Requirements

**Minimum:**

* 8 GB RAM (system memory)
* CPU inference supported
* GGUF runtime (llama.cpp / LM Studio / Ollama)

**Recommended:**

* 12–16 GB RAM or VRAM
* GPU acceleration (NVIDIA preferred)
* Fast SSD for model loading

**Optimal:**

* 8 GB+ VRAM GPU (for smooth Q8 inference)
* CUDA-enabled inference backend

---

## / Model & Links

* Hugging Face: [https://huggingface.co/preferredev/Roblox_Coder_gguf](https://huggingface.co/preferredev/Roblox_Coder_gguf)
* GitHub: https://github.com/preferredev/Roblox-Coder

---

## / Intended Use

This model is intended for:

* Roblox Studio developers
* Luau backend system design
* Learning secure Roblox architecture
* Rapid prototyping of game systems

---

## / License

This project is released under the MIT License.

---

## / Notes

This is an early-stage v1 fine-tune created as a rapid experimental project. Future versions may expand dataset coverage to animation systems, tooling, UI frameworks, and full game development pipelines.

Files changed (1) hide show
  1. README.md +2 -22
README.md CHANGED
@@ -1,23 +1,3 @@
1
  ---
2
- tags:
3
- - gguf
4
- - llama.cpp
5
- - unsloth
6
- - vision-language-model
7
- ---
8
-
9
- # Roblox_Coder_gguf : GGUF
10
-
11
- This model was finetuned and converted to GGUF format using [Unsloth](https://github.com/unslothai/unsloth).
12
-
13
- **Example usage**:
14
- - For text only LLMs: `llama-cli -hf preferredev/Roblox_Coder_gguf --jinja`
15
- - For multimodal models: `llama-mtmd-cli -hf preferredev/Roblox_Coder_gguf --jinja`
16
-
17
- ## Available Model files:
18
- - `Qwen3.5-4B.Q8_0.gguf`
19
- - `Qwen3.5-4B.Q5_K_M.gguf`
20
- - `Qwen3.5-4B.Q4_K_M.gguf`
21
- - `Qwen3.5-4B.F16-mmproj.gguf`
22
- This was trained 2x faster with [Unsloth](https://github.com/unslothai/unsloth)
23
- [<img src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/unsloth%20made%20with%20love.png" width="200"/>](https://github.com/unslothai/unsloth)
 
1
  ---
2
+ license: mit
3
+ ---