aleada commited on
Commit
c72fb33
·
verified ·
1 Parent(s): 94f8a35

fix(card): substitute repo placeholders + drop vision note for text models

Browse files
Files changed (1) hide show
  1. README.md +34 -12
README.md CHANGED
@@ -26,11 +26,10 @@ shims; vLLM auto-detects the quantization config from the embedded
26
  `config.json` at load time.
27
 
28
  This release is part of an ongoing series of vLLM-friendly quantized
29
- packs maintained by
 
30
  [**Alex Adamopoulos**](https://huggingface.co/aleada) at
31
- [**assert.gr**](https://assert.gr) — focused on filling gaps in the
32
- ecosystem where the most popular base models lack production-ready
33
- compressed-tensors weights.
34
 
35
  ## Reproducibility
36
 
@@ -41,12 +40,18 @@ compressed-tensors weights.
41
  | Quantization recipe | GPTQModifier |
42
  | `scheme` | `W4A16` |
43
  | `targets` | `Linear` |
44
- | `ignore` | |
45
  | `sequential_targets` | — |
46
  | Calibration dataset | `lmms-lab/flickr30k` |
47
  | Calibration samples | 512 |
48
  | `max_seq_length` | 2048 |
49
- | Quantized size | 8.56 GiB |
 
 
 
 
 
 
50
 
51
  ## License
52
 
@@ -61,20 +66,36 @@ docker run --runtime=nvidia --gpus all \
61
  -p 8000:8000 \
62
  -e HF_TOKEN=hf_XXX \
63
  vllm/vllm-openai:latest \
64
- --model aleada/{REPO_NAME} \
 
 
65
  --gpu-memory-utilization 0.92 \
66
  --enable-prefix-caching
67
  ```
68
 
69
- vLLM auto-detects `compressed-tensors` from the model's `config.json`
70
- — passing `--quantization compressed-tensors` is allowed but redundant.
 
 
 
 
 
 
 
 
 
 
 
71
 
72
  ## Hardware target
73
 
74
  Requires CUDA compute-capability ≥ 8.0 (Ampere or newer). Verified on
75
  **NVIDIA RTX 3090** (compute 8.6) where the W4A16 path runs the
76
  language tower at INT4 weights / BF16 activations through vLLM's
77
- compressed-tensors kernels.
 
 
 
78
 
79
  ## About the maintainer
80
 
@@ -82,8 +103,9 @@ Alex Adamopoulos is the founder of [assert.gr](https://assert.gr) and
82
  the engineer behind the **atlas** self-evolving AI agent platform.
83
  Atlas runs a planner→executor→supervisor loop over a skill registry,
84
  backed by Postgres, Redis, Qdrant, and a multi-LLM vLLM deployment.
85
- Quantization releases like this one keep the open-source ecosystem
86
- usable on consumer-grade hardware for self-hosted agent research.
 
87
 
88
  Connect:
89
 
 
26
  `config.json` at load time.
27
 
28
  This release is part of an ongoing series of vLLM-friendly quantized
29
+ packs maintained by the [**atlas**](https://github.com/) self-evolving
30
+ agent project, run by
31
  [**Alex Adamopoulos**](https://huggingface.co/aleada) at
32
+ [**assert.gr**](https://assert.gr).
 
 
33
 
34
  ## Reproducibility
35
 
 
40
  | Quantization recipe | GPTQModifier |
41
  | `scheme` | `W4A16` |
42
  | `targets` | `Linear` |
43
+ | `ignore` | `re:.*lm_head`, `re:.*vision_tower.*`, `re:.*multi_modal_projector.*` |
44
  | `sequential_targets` | — |
45
  | Calibration dataset | `lmms-lab/flickr30k` |
46
  | Calibration samples | 512 |
47
  | `max_seq_length` | 2048 |
48
+ | Quantized size | 8.55 GiB |
49
+ | Quantization time | 0.0 min (dual RTX 3090) |
50
+
51
+ The pipeline that produced this artifact lives at
52
+ [`tools/quantize/`](https://github.com/) in the atlas repository — see
53
+ the README there for the full Docker build + run sequence and the
54
+ per-model env-var recipes.
55
 
56
  ## License
57
 
 
66
  -p 8000:8000 \
67
  -e HF_TOKEN=hf_XXX \
68
  vllm/vllm-openai:latest \
69
+ --model aleada/Pixtral-12B-W4A16 \
70
+ --max-model-len 8192 \
71
+ --limit-mm-per-prompt 'image=1' \
72
  --gpu-memory-utilization 0.92 \
73
  --enable-prefix-caching
74
  ```
75
 
76
+ vLLM auto-detects `compressed-tensors` from the model's config — no
77
+ `--quantization` flag required (it is accepted as a redundant hint).
78
+ Once vLLM is running, hit it with any OpenAI client:
79
+
80
+ ```python
81
+ from openai import OpenAI
82
+ client = OpenAI(base_url="http://localhost:8000/v1", api_key="EMPTY")
83
+ resp = client.chat.completions.create(
84
+ model="aleada/Pixtral-12B-W4A16",
85
+ messages=[{"role": "user", "content": "Hello"}],
86
+ )
87
+ print(resp.choices[0].message.content)
88
+ ```
89
 
90
  ## Hardware target
91
 
92
  Requires CUDA compute-capability ≥ 8.0 (Ampere or newer). Verified on
93
  **NVIDIA RTX 3090** (compute 8.6) where the W4A16 path runs the
94
  language tower at INT4 weights / BF16 activations through vLLM's
95
+ compressed-tensors kernels. Vision encoder + multimodal projector
96
+ remain BF16 by design — quantizing them gives negligible memory
97
+ benefit relative to accuracy cost (matches the upstream
98
+ llm-compressor multimodal-vision recommendation).
99
 
100
  ## About the maintainer
101
 
 
103
  the engineer behind the **atlas** self-evolving AI agent platform.
104
  Atlas runs a planner→executor→supervisor loop over a skill registry,
105
  backed by Postgres, Redis, Qdrant, and a multi-LLM vLLM deployment.
106
+ Quantization releases like this one keep the open-source VLM
107
+ ecosystem usable on consumer-grade hardware for self-hosted agent
108
+ research.
109
 
110
  Connect:
111