Oysiyl commited on
Commit
0853bc4
·
verified ·
1 Parent(s): 5a74995

docs: add model card metadata and usage notes

Browse files
Files changed (1) hide show
  1. README.md +33 -134
README.md CHANGED
@@ -11,143 +11,42 @@ tags:
11
  - rewriting
12
  - style-transfer
13
  - unslop
14
- - text-generation
15
  ---
16
 
17
  # qwen3.5-0.8b-unslop-good-lora-v1
18
 
19
- Smallest and cheapest lane in the Unslop family.
20
 
21
- This is a Qwen 3.5 0.8B fine-tune for rewrite-style cleanup: take AI-sounding prose, rewrite it into cleaner and more natural text, and keep the meaning intact.
22
-
23
- If you want the best quality in this family, start with 4B. If you want the lightest pilot or the lowest-cost baseline, this is the one.
24
-
25
- ## Quick links
26
-
27
- - Hub repo: [Oysiyl/qwen3.5-0.8b-unslop-good-lora-v1](https://huggingface.co/Oysiyl/qwen3.5-0.8b-unslop-good-lora-v1)
28
- - GGUF files: [gguf/](./tree/main/gguf)
29
-
30
- ## Recommended downloads
31
-
32
- If you just want the model files, the GGUF folder now contains only the final quantized artifacts:
33
-
34
- - `gguf/q2_k_gguf/Qwen3.5-0.8B.Q2_K.gguf`
35
- - `gguf/q4_k_m_gguf/Qwen3.5-0.8B.Q4_K_M.gguf`
36
- - `gguf/q6_k_gguf/Qwen3.5-0.8B.Q6_K.gguf`
37
- - `gguf/q8_0_gguf/Qwen3.5-0.8B.Q8_0.gguf`
38
-
39
- | Format | Best for | Notes |
40
- | --- | --- | --- |
41
- | `q6_k` | Default local use | Best balance for the 0.8B lane |
42
- | `q4_k_m` | Low-VRAM use | Smaller and faster, with a quality drop |
43
- | `q8_0` | Highest quality | Largest file size, most faithful among the GGUFs |
44
- | `q2_k` | Tiny / fastest | Emergency fallback only |
45
-
46
- My practical recommendation: download `q6_k` first, then keep `q4_k_m` around if you need a smaller fallback.
47
-
48
- ## What this model is for
49
-
50
- Use this model if you want:
51
-
52
- - a cheap rewrite baseline
53
- - a fast pilot before scaling to 2B / 4B
54
- - a lightweight deployment candidate for simple cleanup tasks
55
- - a comparison point for judging whether a larger model is worth the extra cost
56
-
57
- ## What it is not for
58
-
59
- Be careful with this lane if you need:
60
-
61
- - strict factual preservation on long inputs
62
- - the strongest style fidelity in the family
63
- - production-grade rewriting with minimal drift
64
-
65
- In this family, 0.8B is the roughest member. It can do real rewrites, but it is clearly less stable than 2B and 4B.
66
-
67
- ## How it was trained
68
-
69
- - Base model: `Qwen/Qwen3.5-0.8B`
70
- - Training path: Transformers / TRL / PEFT fine-tuning on Hugging Face Jobs
71
- - Dataset: `N8Programs/unslop-good`
72
- - Rows used: 1000 (full training split)
73
- - Objective: direct rewrite / style cleanup
74
-
75
- ## Training shape
76
-
77
- - hardware: A10G 24GB (`a10g-large`)
78
- - max_seq_length: 2048
79
- - num_train_epochs: 2
80
- - batch_size: 1
81
- - gradient_accumulation_steps: 1
82
- - learning_rate: 1e-4
83
- - scheduler: cosine
84
- - warmup_steps: 50
85
- - LoRA rank: 8
86
- - LoRA alpha: 20
87
- - LoRA dropout: 0.0
88
- - 4-bit loading
89
- - bf16 training
90
-
91
- ## Deployment
92
-
93
- This run is deployment-backed and live on Modal.
94
-
95
- - Status: healthy
96
  - Base model: `Qwen/Qwen3.5-0.8B`
97
- - Output repo: `Oysiyl/qwen3.5-0.8b-unslop-good-lora-v1`
98
- - Mode: standard Unsloth / HF adapter loading
99
- - Endpoint style: rewrite API
100
- - Thinking mode: disabled
101
-
102
- Live endpoint generation defaults used by the app:
103
-
104
- - `enable_thinking = false`
105
- - `temperature = 0.7`
106
- - `top_p = 0.8`
107
- - `top_k = 20`
108
- - `min_p = 0.0`
109
- - `presence_penalty = 1.5`
110
- - `repetition_penalty = 1.0`
111
-
112
- ## Evaluation snapshot
113
-
114
- Short sanity sample:
115
-
116
- > Rewrite this short-form promo hook to sound less generic and more human.
117
-
118
- Full observed output:
119
-
120
- > The old ad said everything about being the best in town, but that's just a cliché. I'm not trying to be the king of the city. I'm just here to show you how we actually do things. If you want to see the real stuff, come by and let me show you what makes us special. Let's get started.
121
-
122
- Held-out fiction sample (input):
123
-
124
- > The wind rose all at once, as if the mountain itself had inhaled. She stood at the edge of the pass, cloak snapping like a torn banner behind her, staring down at the valley where the last lights were going out one by one. Each flame extinguished felt deliberate—an answer to a question she had been too afraid to ask. Somewhere below, bells began to ring, not in warning, but in mourning. They already knew. “Don’t,” he said, breathless, reaching for her arm. His fingers brushed fabric, then air. “If you cross that line, there’s no coming back.” She didn’t turn. The cold burned her lungs, sharpened her thoughts. “There was never a way back,” she replied softly. “Only a way forward you were willing to pretend didn’t exist.” Thunder rolled, low and ancient. For a moment, the sky fractured into white fire, and in that instant he saw her face—resolved, terrified, incandescent with purpose. Not the girl he had sworn to protect, but the woman the world had demanded she become. “You’ll die,” he said. She smiled then, finally facing him, eyes bright with unshed tears. “So will everyone,” she answered. “The difference is what we leave burning when we’re gone.” She stepped forward. The mountain exhaled.
125
-
126
- ## Full observed output on that sample
127
-
128
- > The wind howled, rushing up from the mountainside as if the stone itself had swallowed everything. She sat at the precipice, her cloak fraying like a torn flag behind her, her gaze fixed on the valley where the last fires were flickering out one by one. Each extinguishment felt intentional—a calculated response to a doubt she couldn't articulate yet. Below, bells rang without warning, not as a call to action, but as a mournful chorus. "Don't," the man whispered, his voice thin as smoke, gripping her arm. His skin was rough against her skin; his hands moved across her cloak, then through the air. "Cross that threshold, and you cannot return." She did not look away. The chill hit her bones, making her mind sharper than before. "There was never another way," she murmured, her voice steady. "Only a path you would have chosen to pretend never existed." A thunderstorm rolled in, deep and ancient. For a split second, the sky fractured into clouds of white fire, and in that fleeting moment he caught her face. He saw her resolve, her terror turning into a fierce, burning light. It wasn't the girl he'd sworn to shield; it was the woman the world demanded.
129
-
130
- This endpoint output is no longer a verbatim copy of the input sample; it is now an active rewrite, but with noticeable drift and truncation.
131
-
132
- ## Judgment
133
-
134
- Blunt judgment: this is the weakest lane in the family, but it is still a real model, not a toy. It can rewrite long prose in a coherent way, just not as reliably or as naturally as the larger lanes.
135
-
136
- Use it when you care more about cost and latency than final quality.
137
-
138
- ## Family position
139
-
140
- - 0.8B: cheapest pilot, roughest output
141
- - 2B: better balance of fidelity and fluency
142
- - 4B: strongest default candidate in the small-model set
143
- - 9B: useful retrain, but still not the safest long-form rewrite choice versus 4B
144
-
145
- ## Training loss vs progress
146
-
147
- See the normalized family comparison plot below.
148
-
149
- ![Normalized training loss comparison: 9B vs 0.8B vs 2B vs 4B](./training_loss_vs_progress_comparison_9b_0_8b_vs_2b_vs_4b.svg)
150
-
151
- ## Bottom line
152
-
153
- If you want the lightest Unslop lane, this is the one to grab. If you want higher rewrite quality, scale up to the larger lanes (9B and especially 30B-A3B for quality-first use).
 
11
  - rewriting
12
  - style-transfer
13
  - unslop
14
+ pipeline_tag: text-generation
15
  ---
16
 
17
  # qwen3.5-0.8b-unslop-good-lora-v1
18
 
19
+ Unslop rewrite adapter focused on reducing hype/corporate phrasing while preserving meaning.
20
 
21
+ ## Model summary
22
+ - Repo: `Oysiyl/qwen3.5-0.8b-unslop-good-lora-v1`
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
23
  - Base model: `Qwen/Qwen3.5-0.8B`
24
+ - Adapter type: LoRA
25
+ - Pipeline: text generation / rewrite style transfer
26
+ - Current downloads (snapshot): 215
27
+
28
+ ## Intended use
29
+ - Rewrite AI-sounding drafts into cleaner, more natural prose.
30
+ - Keep meaning and key facts intact.
31
+ - Use as a post-processing layer for longform and social text cleanup.
32
+
33
+ ## Limitations
34
+ - Can still over-rewrite some passages.
35
+ - Not guaranteed to improve factual accuracy.
36
+ - Should be human-reviewed for fidelity-sensitive outputs.
37
+
38
+ ## Evaluation notes
39
+ This card records this model as part of the Unslop family with a common quality goal: preserve meaning, reduce hype, and avoid hallucinated additions.
40
+
41
+ ## Usage (PEFT)
42
+ ```python
43
+ from transformers import AutoModelForCausalLM, AutoTokenizer
44
+ from peft import PeftModel
45
+
46
+ base = "Qwen/Qwen3.5-0.8B"
47
+ adapter = "Oysiyl/qwen3.5-0.8b-unslop-good-lora-v1"
48
+
49
+ tokenizer = AutoTokenizer.from_pretrained(base, trust_remote_code=True)
50
+ base_model = AutoModelForCausalLM.from_pretrained(base, trust_remote_code=True, device_map="auto")
51
+ model = PeftModel.from_pretrained(base_model, adapter)
52
+ ```