HanzoHuang commited on
Commit
094237b
·
verified ·
1 Parent(s): d5c5e40

Document RKLLM artifacts and checksums

Browse files
Files changed (1) hide show
  1. README.md +19 -26
README.md CHANGED
@@ -14,32 +14,31 @@ tags:
14
 
15
  # Llama-3.2-1B-Instruct-RKLLM
16
 
17
- RKLLM-converted versions of Llama 3.2 1B Instruct for deployment on Rockchip RK3576 and RK3588 NPUs.
18
 
19
- `.rkllm` files require the Rockchip RKLLM runtime and cannot be loaded directly with Transformers, llama.cpp, or Ollama.
20
 
21
- ## Base Model
22
 
23
- - Model: Llama 3.2 1B Instruct
24
- - Author: Meta
25
- - Original model: [meta-llama/Llama-3.2-1B-Instruct](https://huggingface.co/meta-llama/Llama-3.2-1B-Instruct)
26
- - Original license: Llama 3.2 Community License
27
 
28
- Access to the upstream model is gated. Refer to its model card, license, and acceptable-use policy before using these converted artifacts.
29
 
30
- ## Available Variants
31
 
32
- | Target | File | Quantization |
33
- | --- | --- | --- |
34
- | RK3576 | [`Llama-3.2-1B-Instruct_RK3576_w4a16_g128.rkllm`](RK3576/Llama-3.2-1B-Instruct_RK3576_w4a16_g128.rkllm) | W4A16 (g128) |
35
- | RK3576 | [`Llama-3.2-1B-Instruct_RK3576_w8a8.rkllm`](RK3576/Llama-3.2-1B-Instruct_RK3576_w8a8.rkllm) | W8A8 |
36
- | RK3588 | [`Llama-3.2-1B-Instruct_RK3588_w8a8.rkllm`](RK3588/Llama-3.2-1B-Instruct_RK3588_w8a8.rkllm) | W8A8 |
37
 
38
- The repository also contains `Llama-3.2-1B-Instruct_data_quant.json`, the calibration data used during conversion.
 
 
 
 
39
 
40
- ## Usage
41
 
42
- Download the model variant that matches your target SoC:
43
 
44
  ```bash
45
  hf download HanzoHuang/Llama-3.2-1B-Instruct-RKLLM \
@@ -47,18 +46,12 @@ hf download HanzoHuang/Llama-3.2-1B-Instruct-RKLLM \
47
  --local-dir Llama-3.2-1B-Instruct-RKLLM
48
  ```
49
 
50
- Load the `.rkllm` file with a compatible RKLLM runtime and apply the Llama 3.2 Instruct chat template in your application.
51
 
52
  ## Limitations
53
 
54
- - These are hardware-specific converted artifacts, not Transformers checkpoints.
55
- - Runtime, driver, and toolkit compatibility depends on the Rockchip software stack installed on the device.
56
- - Conversion may change output quality relative to the upstream floating-point model; validate on your own workload.
57
-
58
- ## License
59
-
60
- Use of these converted artifacts remains subject to the Llama 3.2 Community License and applicable upstream terms.
61
 
62
  ## Acknowledgements
63
 
64
- Thanks to Meta for releasing Llama 3.2 and to Rockchip and RKLLM contributors for the deployment toolchain.
 
14
 
15
  # Llama-3.2-1B-Instruct-RKLLM
16
 
17
+ RKLLM-converted Llama 3.2 1B Instruct language-model artifacts for Rockchip RK3576 and RK3588 NPUs.
18
 
19
+ These hardware-specific `.rkllm` files require a compatible Rockchip RKLLM runtime. They are not Transformers checkpoints and cannot be loaded directly with Transformers, llama.cpp, or Ollama.
20
 
21
+ ## Base model
22
 
23
+ - Upstream model: [meta-llama/Llama-3.2-1B-Instruct](https://huggingface.co/meta-llama/Llama-3.2-1B-Instruct)
24
+ - License: Llama 3.2 Community License
25
+ - Model type: LLM (text only)
 
26
 
27
+ The upstream model is gated. Review Meta's license and acceptable-use policy before use or redistribution.
28
 
29
+ ## Conversion and variants
30
 
31
+ Converted with RKLLM Toolkit 1.3.0. Use a file built for the exact target SoC.
 
 
 
 
32
 
33
+ | Target | Quantization | File | SHA256 |
34
+ | --- | --- | --- | --- |
35
+ | RK3576 | W4A16 (g128) | [Llama-3.2-1B-Instruct_RK3576_w4a16_g128.rkllm](RK3576/Llama-3.2-1B-Instruct_RK3576_w4a16_g128.rkllm) | `bd6cbbf84e90b63d451e672a542858a5a6aa15ad2b45f83e1b5dbcd944ac3018` |
36
+ | RK3576 | W8A8 | [Llama-3.2-1B-Instruct_RK3576_w8a8.rkllm](RK3576/Llama-3.2-1B-Instruct_RK3576_w8a8.rkllm) | `9c4d103f7c486740ba75605c61a51b80d170df067645360ffad8464b50c764df` |
37
+ | RK3588 | W8A8 | [Llama-3.2-1B-Instruct_RK3588_w8a8.rkllm](RK3588/Llama-3.2-1B-Instruct_RK3588_w8a8.rkllm) | `4403aec1c018c7ebf29c95730336e848aff8824e3be3bd6be7db44b4a4973bad` |
38
 
39
+ The repository also includes `Llama-3.2-1B-Instruct_data_quant.json`, used as calibration data during conversion.
40
 
41
+ ## Usage
42
 
43
  ```bash
44
  hf download HanzoHuang/Llama-3.2-1B-Instruct-RKLLM \
 
46
  --local-dir Llama-3.2-1B-Instruct-RKLLM
47
  ```
48
 
49
+ Use the Llama 3.2 Instruct chat template with the RKLLM runtime. For Docker deployment, see [Hanzo-Huang/rkllm-docker](https://github.com/Hanzo-Huang/rkllm-docker).
50
 
51
  ## Limitations
52
 
53
+ These are target-specific converted artifacts. Validate quality, memory use, and runtime compatibility on your own Rockchip device.
 
 
 
 
 
 
54
 
55
  ## Acknowledgements
56
 
57
+ Thanks to Meta, Rockchip, and the RKLLM community.