kgrabko commited on
Commit
6b23d70
Β·
verified Β·
1 Parent(s): 25169c2

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +288 -0
README.md ADDED
@@ -0,0 +1,288 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - en
4
+ - zh
5
+ - ja
6
+ - ko
7
+ - fr
8
+ - es
9
+ - pt
10
+ - de
11
+ - it
12
+ - ru
13
+ - ar
14
+ - vi
15
+ - th
16
+ tags:
17
+ - text-generation
18
+ - deltanet
19
+ - qwen3.8
20
+ - gguf
21
+ - cpu
22
+ - efficient
23
+ - low-memory
24
+ - ternary
25
+ - bitnet
26
+ - jirack
27
+ - web-ui
28
+ - routing
29
+ - tool-call
30
+ - robotics
31
+ - ollama
32
+ license: mit
33
+ ---
34
+
35
+ # JiRack DeltaNet 27B (CPU)
36
+ A fast and efficient 27B model optimized for CPU inference. Built on a Qwen3.5-style DeltaNet architecture (hybrid attention + SSM), with an updated tokenizer that includes **Routing**, **Media**, **Vision**, **Sound**, **Tool call**, and **Robotics** tags. Ready-to-run GGUF quantizations, and native Ollama support with reasoning disabled by default for fast, direct responses.
37
+ - JiRack is a cloud-ready model that helps save money on cloud infrastructure. It can be used as an expert model in RAG deployments, with the ONNX JiRack Java server as an alternative.
38
+ - Subscription: **$1 per month per user** (updated license for non-company use).
39
+ - Corp Subscription: **$3 per month per user** (updated license for company use).
40
+ - It works without subscription but send message about subscription
41
+
42
+
43
+ # JiRack service options
44
+ - Current quantizations were done from the FP16 model.
45
+ - If you need custom compression or fine-tuning, please write to me and I'll perform QAT from your dataset, tailored specifically to your task.
46
+ - Plus double QAT via ONNX QAT.
47
+ - Adapt train process to avoid catastrophic forgetting with NDA
48
+ - Adapt train process to avoid fast plateau in training with NDA
49
+ - Adapts to agentic or instruct models for tool calling, using the JiRack tokenizer to enable high-quality tool calling on small models β€” built as a domain-specific tool expert.
50
+ - Deployment and scale
51
+
52
+
53
+ # Ollama production support
54
+ - JiRack DeltaNet 27B runs natively on Ollama with reasoning disabled by default (no forced `<think>` blocks).
55
+ - Available now: **`cmsmanhattan/JiRackDeltaNet_27b-q4`** β€” https://ollama.com/cmsmanhattan
56
+ - Runtime override also supported: `ollama run cmsmanhattan/JiRackDeltaNet_27b-q4 --think=false`
57
+ - Follow fresh Ollama platform updates
58
+
59
+
60
+ # Spring Boot AI tool calls examples for JiRack DeltaNet series
61
+ - Tool call library on java for Enterprise https://github.com/alibaba/spring-ai-alibaba
62
+
63
+ # GoEx AI tool calls examples for JiRack DeltaNet series
64
+ - Tool call library on python https://github.com/ShishirPatil/gorilla
65
+
66
+ # JiRack DeltaNet tool calls to boost tool call quality
67
+ - Use JiRack Precision tokenizer tags for tool calls with ToolBench https://github.com/OpenBMB/ToolBench
68
+ - https://huggingface.co/xalss/Qwen2-7B-Instruct-glaive-function-calling
69
+ - https://huggingface.co/datasets/NousResearch/hermes-function-calling-v1
70
+ - Add JiRack tool call tags in the dataset and modify tool call processor if needed
71
+
72
+
73
+ # JiRack RoboTech
74
+ - Advanced Tokenizer with Robotics & Routing & Tool calls Tokenizer and other
75
+ - [CMSManhattan/JiRackPrecisionTokenizer](https://huggingface.co/CMSManhattan/JiRackPrecisionTokenizer)
76
+
77
+
78
+ ## Available Variants
79
+ | Tag | Quant | Size | Approx. RAM | Description |
80
+ |-----|-------|------|-------------|-------------|
81
+ | `cmsmanhattan/jirack-deltanet-27b-cpu:latest` | Full | ~55 GB | ~56–64 GB | Full precision reference |
82
+ | `cmsmanhattan/jirack-deltanet-27b-cpu-q4:latest` | Q4_K_M | ~16.8 GB | ~18–24 GB | Recommended balance |
83
+ | `cmsmanhattan/jirack-deltanet-27b-cpu-q3:latest` | Q3_K_M | ~13.9 GB | ~15–20 GB | Good quality / size trade-off |
84
+ | `cmsmanhattan/jirack-deltanet-27b-cpu-q2:latest` | Q2_K | ~11.2 GB | ~12–17 GB | Maximum compression |
85
+
86
+ ## Quick Start
87
+
88
+ ### Run with Ollama (recommended β€” reasoning off by default)
89
+ ```bash
90
+ ollama pull cmsmanhattan/JiRackDeltaNet_27b-q4
91
+ ollama run cmsmanhattan/JiRackDeltaNet_27b-q4 "What is the capital of France?"
92
+ ```
93
+
94
+ ### Run with Docker
95
+ - 27B docker images can be provided by request.
96
+ - Build docker on local from source or request from me.
97
+
98
+ **Default CPU (Q4 recommended)**
99
+ ```bash
100
+ docker run -d \
101
+ --name jirack_deltanet_27b \
102
+ -p 7869:7869 \
103
+ --restart unless-stopped \
104
+ cmsmanhattan/jirack-deltanet-27b-cpu-q4:latest
105
+ ```
106
+ **Q3**
107
+ ```bash
108
+ docker run -d \
109
+ --name jirack_deltanet_27b \
110
+ -p 7869:7869 \
111
+ --cpus=16 \
112
+ -e THREADS=16 \
113
+ -e THREADS_BATCH=16 \
114
+ --restart unless-stopped \
115
+ cmsmanhattan/jirack-deltanet-27b-cpu-q3:latest
116
+ ```
117
+ **Q2 (lowest memory)**
118
+ ```bash
119
+ docker run -d \
120
+ --name jirack_deltanet_27b \
121
+ -p 7869:7869 \
122
+ --cpus=16 \
123
+ -e THREADS=16 \
124
+ -e THREADS_BATCH=16 \
125
+ --restart unless-stopped \
126
+ cmsmanhattan/jirack-deltanet-27b-cpu-q2:latest
127
+ ```
128
+ **Full precision**
129
+ ```bash
130
+ docker run -d \
131
+ --name jirack_deltanet_27b \
132
+ -p 7869:7869 \
133
+ --cpus=16 \
134
+ -e THREADS=16 \
135
+ -e THREADS_BATCH=16 \
136
+ --restart unless-stopped \
137
+ cmsmanhattan/jirack-deltanet-27b-cpu:latest
138
+ ```
139
+ **Multi CPU**
140
+ ```bash
141
+ docker run -d \
142
+ --name jirack_deltanet_27b \
143
+ -p 7869:7869 \
144
+ --cpus=16 \
145
+ -e THREADS=16 \
146
+ -e THREADS_BATCH=16 \
147
+ --restart unless-stopped \
148
+ --memory=32g \
149
+ --cpus=8 \
150
+ cmsmanhattan/jirack-deltanet-27b-cpu-q4:latest
151
+ ```
152
+
153
+ ### Docker Compose Example
154
+ ```yaml
155
+ services:
156
+ jirack:
157
+ image: cmsmanhattan/jirack-deltanet-27b-cpu-q4:latest
158
+ container_name: jirack_deltanet_27b
159
+ ports:
160
+ - "7869:7869"
161
+ volumes:
162
+ - .:/app
163
+ - ./web:/app/web
164
+ environment:
165
+ - MAX_TOKENS=2048
166
+ - TEMPERATURE=0.7
167
+ - TOP_P=0.8
168
+ - TOP_K=20
169
+ - DEFAULT_STREAM=False
170
+ - INTRA_THREADS=4
171
+ - USE_ENV_ALLOCATOR=1
172
+ - THREADS=16
173
+ - THREADS_BATCH=16
174
+ deploy:
175
+ resources:
176
+ limits:
177
+ memory: 32g
178
+ ```
179
+
180
+ ## Access the UI
181
+ Once the container is running, open your browser and navigate to:
182
+ `http://localhost:7869`
183
+ This opens the JiRack UI β€” a clean web interface.
184
+
185
+ ## Changing the Port
186
+ The listening port can be easily modified directly from the **Settings** panel within the JiRack UI.
187
+
188
+ ## Licensing
189
+ - The JiRack DeltaNet 27B model is provided under a commercial license ($12 per user per year).
190
+ - All JiRack UI clients are provided under a commercial license.
191
+ - However, the UI clients can be used for free when running together with the official JiRack Docker containers, as long as they are not redistributed separately.
192
+
193
+ For commercial licensing, cluster deployment, or enterprise use of JiRack models, please contact us.
194
+ - **JiRack MS Windows 11 Desktop Client (with Ollama API):**
195
+ https://huggingface.co/kgrabko/JiRackTernary_1b/resolve/main/jirack-chat.zip
196
+ - **Live email chat with the model:** support@cmsmanhattan.com
197
+
198
+ ## Hardware Recommendations
199
+
200
+ ### Recommended Hardware for JiRack DeltaNet 27B (single Docker container)
201
+ | Use Case | CPU | RAM | Recommended Quant | Expected Speed | Recommendation |
202
+ |-------------------|----------------------------|-----------|--------------------|---------------------|----------------|
203
+ | Recommended | Ryzen 9 / Intel i9 / Xeon | 24–32 GB | Q4_K_M | Good interactive | Best choice |
204
+ | High Performance | High-core server CPU | 48 GB+ | Full / Q4 | Excellent | Excellent |
205
+ | Low Memory | Modern 12+ core CPU | 16–24 GB | Q3_K_M or Q2_K | Usable | Acceptable |
206
+ | Edge / Minimal | Strong workstation CPU | 16 GB | Q2_K | Acceptable | Budget option |
207
+
208
+ ## Important Memory Notes
209
+ Even though the quantized 27B models are relatively compact for their size, we recommend the following for best experience:
210
+ - Q4_K_M: 18–24 GB system RAM minimum
211
+ - Q3_K_M / Q2_K: 15–20 GB system RAM
212
+ - Full precision: 48 GB+ system RAM recommended
213
+
214
+ Reasons for extra headroom:
215
+ - KV-cache consumption during generation
216
+ - Runtime overhead and temporary buffers
217
+ - System stability and avoiding out-of-memory errors
218
+ - Room for larger context windows
219
+
220
+ **Minimum recommended (Q4):** 18 GB system RAM
221
+ **Ideal:** 24–32 GB system RAM
222
+
223
+ I added the default model in full precision. This serves as the base for quantization, allowing us to find the optimal balance between model size and performance.
224
+
225
+ ## Architecture Notes
226
+ - **Qwen3.5-style DeltaNet architecture**: hybrid attention + SSM design (`qwen35` in GGUF metadata)
227
+ - **Updated tokenizer**: Extended with new special tags for **Routing**, **Tool call**, and **Robotics**
228
+ - **No-forced-reasoning support**: chat template patched so `<think>` blocks default to closed; native support on Ollama
229
+ - Hidden 5120, 65 layers, attention heads 24 / KV heads 4, feed-forward 17408
230
+ - SSM: conv kernel 4, state size 128, group count 16, time-step rank 48, inner size 6144
231
+ - RoPE ΞΈ = 10,000,000, RMSNorm Ξ΅ = 1e-6
232
+ - Context length: up to 262,144 tokens
233
+ - Ready-to-run GGUF quantizations (Q2_K, Q3_K_M, Q4_K_M)
234
+
235
+ ## Benchmarks
236
+ JiRack DeltaNet 27B is built on the Qwen3.5/Qwen3.8-style DeltaNet architecture. The table below reproduces the published base-model benchmark results from [Qwen/Qwen3.8-27B](https://huggingface.co/Qwen/Qwen3.8-27B) for reference β€” these reflect the upstream base model's capabilities, not JiRack-specific fine-tuning or quantization results.
237
+
238
+ ### Text Performance
239
+
240
+ | | Qwen3.8-27B | Qwen3.6-27B | Qwen3.7-Plus | Muse Glimmer-30B | Opus4.6 Max |
241
+ |---------------------------------------------------------|-------------|-------------|--------------|-------------------|-------------|
242
+ | **Coding** | | | | | |
243
+ | Agentic terminal coding β€” Terminal Bench 2.1 (Terminus) | 73.0 | 63.4 | 64.0 | 51.7 | **78.2** |
244
+ | Agentic coding β€” SWE-bench Pro | **61.7** | 53.5 | 57.6 | 51.2 | 53.4 |
245
+ | Repo-level code generation β€” NL2Repo-Bench | 42.3 | 36.2 | 41.1 | -- | **47.6** |
246
+ | Agentic coding β€” DeepSWE 1.1 | **42.2** | 13.3 | 14.2 | -- | -- |
247
+ | Software engineering β€” QwenSWEBench | **79.0** | 49.3 | 59.2 | -- | 63.8 |
248
+ | **Agent** | | | | | |
249
+ | Long-horizon office work β€” CoWorkBench | **70.7** | 61.0 | 65.1 | -- | 68.2 |
250
+ | Professional job tasks β€” JobBench | **33.4** | 21.8 | 27.6 | -- | -- |
251
+ | Frontier agentic tasks β€” Agents' Last Exam (Pass@1/Score)| **20.4 / 42.9** | 10.6 / 27.3 | 13.2 / 33.6 | -- | -- |
252
+ | **General** | | | | | |
253
+ | Instruction following β€” IFBench | **79.5** | 69.1 | 79.1 | 77.0 | 62.5 |
254
+ | Scientific reasoning β€” GPQA Diamond | 89.2 | 87.8 | 90.3 | 83.5 | **91.3** |
255
+ | Multidisciplinary reasoning β€” HLE | 30.8 | 24.0 | 34.7 | 22.0 | **40.0** |
256
+ | Competitive coding β€” LiveCodeBench v6 | **90.3** | 83.9 | 89.6 | -- | 88.8 |
257
+
258
+ ### VL Performance
259
+
260
+ | | Qwen3.8-27B | Qwen3.6-27B | Qwen3.7-Plus | Muse Glimmer-30B | Opus4.6 Max |
261
+ |------------------------------------------|-------------|-------------|--------------|-------------------|-------------|
262
+ | **Agentic Multimodal Intelligence** | | | | | |
263
+ | Computer use β€” OSWorld-Verified | **84.3** | 63.9 | 73.3 | 65.9 | 72.7 |
264
+ | Browser use β€” WebArena-Verified | **64.8** | 48.8 | 55.3 | -- | -- |
265
+ | Mobile use β€” AndroidWorld | **81.9** | 70.3 | 81.0 | -- | 62.0 |
266
+ | Application recreation β€” RecreationBench | **47.1** | 29.8 | 30.2 | -- | -- |
267
+ | Multimodal tool use β€” ClawEval-MM (Pass@3/Avg) | 57.4 / 56.9 | 42.6 / 50.4 | **57.4 / 60.1** | -- | 52.5 / 54.7 |
268
+ | Multimodal SWE β€” SWE-MM | **38.6** | 25.7 | 30.0 | -- | 27.1 |
269
+ | Visual web development β€” Vision2Web | **62.9** | 45.0 | 42.1 | -- | -- |
270
+ | **General Multimodal Intelligence** | | | | | |
271
+ | Visual math β€” MathVision (w/o CI / w/ CI)| 90.0 / **94.6** | 85.1 / -- | **90.3** / -- | -- | 65.5 / -- |
272
+ | General visual reasoning β€” BabyVision (w/o CI / w/ CI) | **65.7 / 85.6** | 28.9 / -- | 64.7 / 70.4 | -- | 12.6 / -- |
273
+ | Scientific chart analysis β€” CharXiv (RQ) (w/o CI / w/ CI) | 83.7 / **90.2** | 78.4 / -- | **85.8** / 85.9 | 78.8 | 66.0 / -- |
274
+ | Document intelligence β€” OmniDocBench 1.5 | 91.1 | 89.4 | **91.4** | 75.8 | 86.6 |
275
+ | Real-world perception β€” RealWorldQA | 85.9 | 84.1 | **86.9** | -- | 73.9 |
276
+ | Embodied intelligence β€” ERQA | 65.5 | 62.5 | **69.8** | -- | 40.8 |
277
+
278
+ *Source: [Qwen/Qwen3.8-27B model card](https://huggingface.co/Qwen/Qwen3.8-27B). Best result in each row is bolded. Empty cells (--) indicate results not yet available. See the source card for full evaluation methodology and footnotes.*
279
+
280
+ ## πŸ“§ Contact & Licensing
281
+ For joint venture opportunities, hardware integration, or licensing inquiries:
282
+ - **Email:** grabko@cmsmanhattan.com
283
+ - **Phone:** +1 (516) 777-0945
284
+ - **Location:** New York, USA
285
+
286
+
287
+ ## License
288
+ MIT License