Instructions to use jasontcip/visp-threejs-lora with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use jasontcip/visp-threejs-lora with MLX:
# Download the model from the Hub pip install huggingface_hub[hf_xet] huggingface-cli download --local-dir visp-threejs-lora jasontcip/visp-threejs-lora
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
Upload Visp Three.js LoRA adapter
Browse files- README.md +50 -0
- adapter_config.json +40 -0
- adapters.safetensors +3 -0
README.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
base_model: Qwen/Qwen2.5-Coder-1.5B-Instruct
|
| 4 |
+
library_name: mlx
|
| 5 |
+
tags:
|
| 6 |
+
- mlx
|
| 7 |
+
- lora
|
| 8 |
+
- code-generation
|
| 9 |
+
- threejs
|
| 10 |
+
- game-development
|
| 11 |
+
---
|
| 12 |
+
|
| 13 |
+
# Visp Three.js LoRA Adapter
|
| 14 |
+
|
| 15 |
+
Visp is a Three.js-focused LoRA adapter trained on top of `Qwen/Qwen2.5-Coder-1.5B-Instruct`.
|
| 16 |
+
|
| 17 |
+
This repository contains the selected Visp checkpoint from the local evaluation run:
|
| 18 |
+
|
| 19 |
+
- Adapter checkpoint: `ckpt_010`
|
| 20 |
+
- Base model: `Qwen/Qwen2.5-Coder-1.5B-Instruct`
|
| 21 |
+
- Fine-tuning type: LoRA
|
| 22 |
+
- LoRA rank: 8
|
| 23 |
+
- LoRA scale: 20
|
| 24 |
+
- Training framework: MLX LM
|
| 25 |
+
|
| 26 |
+
## Intended Use
|
| 27 |
+
|
| 28 |
+
Visp is intended for generating and repairing self-contained Three.js / TypeScript browser game examples.
|
| 29 |
+
|
| 30 |
+
## Evaluation Summary
|
| 31 |
+
|
| 32 |
+
The selected checkpoint was promoted because it had the best local expanded benchmark result while preserving the original benchmark:
|
| 33 |
+
|
| 34 |
+
- Expanded visual pass rate: `0.96`
|
| 35 |
+
- Expanded compile pass rate: `1.0`
|
| 36 |
+
- Original pass rate: `1.0`
|
| 37 |
+
|
| 38 |
+
## Local Usage
|
| 39 |
+
|
| 40 |
+
```bash
|
| 41 |
+
python3 -m mlx_lm.chat \
|
| 42 |
+
--model Qwen/Qwen2.5-Coder-1.5B-Instruct \
|
| 43 |
+
--adapter-path ./ckpt_010
|
| 44 |
+
```
|
| 45 |
+
|
| 46 |
+
If downloaded directly from the Hub, point `--adapter-path` at the folder containing `adapters.safetensors` and `adapter_config.json`.
|
| 47 |
+
|
| 48 |
+
## Notes
|
| 49 |
+
|
| 50 |
+
This is an adapter-only upload. It does not include the base Qwen model weights.
|
adapter_config.json
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"adapter_path": "adapters/threejs_student_visual_v2/20260429-143537-resume-fail4",
|
| 3 |
+
"batch_size": 1,
|
| 4 |
+
"config": null,
|
| 5 |
+
"data": "runs/visp/gold_fail4_lite/repair_data_nonempty_valid",
|
| 6 |
+
"fine_tune_type": "lora",
|
| 7 |
+
"grad_accumulation_steps": 1,
|
| 8 |
+
"grad_checkpoint": false,
|
| 9 |
+
"iters": 50,
|
| 10 |
+
"learning_rate": 2e-06,
|
| 11 |
+
"lora_parameters": {
|
| 12 |
+
"rank": 8,
|
| 13 |
+
"dropout": 0.0,
|
| 14 |
+
"scale": 20.0
|
| 15 |
+
},
|
| 16 |
+
"lr_schedule": null,
|
| 17 |
+
"mask_prompt": true,
|
| 18 |
+
"max_seq_length": 2048,
|
| 19 |
+
"model": "./Qwen2.5-Coder-1.5B-Instruct",
|
| 20 |
+
"num_layers": 16,
|
| 21 |
+
"optimizer": "adam",
|
| 22 |
+
"optimizer_config": {
|
| 23 |
+
"adam": {},
|
| 24 |
+
"adamw": {},
|
| 25 |
+
"muon": {},
|
| 26 |
+
"sgd": {},
|
| 27 |
+
"adafactor": {}
|
| 28 |
+
},
|
| 29 |
+
"project_name": null,
|
| 30 |
+
"report_to": null,
|
| 31 |
+
"resume_adapter_file": "adapters/threejs_student_visual_v2/20260429-124201-stage-b/adapters.safetensors",
|
| 32 |
+
"save_every": 10,
|
| 33 |
+
"seed": 0,
|
| 34 |
+
"steps_per_eval": 200,
|
| 35 |
+
"steps_per_report": 10,
|
| 36 |
+
"test": false,
|
| 37 |
+
"test_batches": 500,
|
| 38 |
+
"train": true,
|
| 39 |
+
"val_batches": 25
|
| 40 |
+
}
|
adapters.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:7ab732a7448b7b1dd01809df062e8affdcd30c2f616d2d9df73b7344f34ef41a
|
| 3 |
+
size 21126646
|