Hugging Face's logo

qualcomm
/
Llama-v2-7B-Chat

Text Generation
PyTorch
llm
generative_ai
quantized
android
Model card Files Community
8
Llama-v2-7B-Chat / README.md
bhushans's picture
bhushans
adding export and demo instructions
55992e7 verified
preview code
|
raw
history blame
6.18 kB
metadata
library_name: pytorch
license: llama2
pipeline_tag: text-generation
tags:
  - llm
  - generative_ai
  - quantized
  - android

Llama-v2-7B-Chat: Optimized for Mobile Deployment

State-of-the-art large language model useful on a variety of language understanding and generation tasks

Llama 2 is a family of LLMs. The "Chat" at the end indicates that the model is optimized for chatbot-like dialogue. The model is quantized to 4-bit weights and 16-bit activations making it suitable for on-device deployment. For Prompt and output length specified below, the time to first token is Llama-PromptProcessor-Quantized's latency and average time per addition token is Llama-TokenGenerator-KVCache-Quantized's latency.

This is based on the implementation of Llama-v2-7B-Chat found here. More details on model performance accross various devices, can be found here.

Model Details

  • Model Type: Text generation
  • Model Stats:
    • Number of parameters: 7B
    • Model size: 3.6GB
    • Model-1 (Prompt Processor): Llama-PromptProcessor-Quantized
    • Max context length: 1024
    • Prompt processor input: 1024 tokens
    • Prompt processor output: 1024 output tokens + KVCache for token generator
    • Model-2 (Token Generator): Llama-TokenGenerator-KVCache-Quantized
    • Token generator input: 1 input token + past KVCache
    • Token generator output: 1 output token + KVCache for next iteration
    • Decoding length: 1024 (1 output token + 1023 from KVCache)
    • Use: Initiate conversation with prompt-processor and then token generator for subsequent iterations.
    • QNN-SDK: 2.19
Device Chipset Target Runtime Inference Time (ms) Peak Memory Range (MB) Precision Primary Compute Unit Target Model
Samsung Galaxy S23 Ultra (Android 13) Snapdragon® 8 Gen 2 QNN Model Library 104.953 ms 316 - 4785 MB UINT16 NPU Llama-TokenGenerator-KVCache-Quantized
Samsung Galaxy S23 Ultra (Android 13) Snapdragon® 8 Gen 2 QNN Model Library 1917.811 ms 0 - 1028 MB UINT16 NPU Llama-PromptProcessor-Quantized

Deploying Llama 2 on-device

Large Language Model (LLM) such as Llama 2 has the following complexities to deploy on-device:

  1. Model size is too large to fit in device memory for inference
  2. Multi-Head Attention (MHA) has large activations leading to fallback from accelerators
  3. High model load and inference time

We can tackle the above constraints with the following steps:

  1. Quantize weights to reduce on-disk model size, e.g., int8 or int4 weights
  2. Quantize activations to reduce inference time memory pressure
  3. Graph transformations to reduce inference time memory pressure, e.g., Multi-Head to Split-Head Attention (MHA -> SHA)
  4. Graph transformations to convert or decompose operations into more accelerator friendly operations e.g. Linear to Conv
  5. For LLM with 7B or more parameters, above steps are still not good enough on mobile, hence we go one step further and split model into sub-parts.

Here, we divide the model into 4 parts in order to

  1. Make model exportable with low memory usage
  2. Avoid inference time out-of-memory errors

In order to export Llama 2, please ensure

  1. Host machine has >40GB memory (RAM+swap-space)
  2. If you don't have enough memory, export.py will dump instructions to increase swap space accordingly

Example & Usage

Install the package via pip:

pip install "qai_hub_models[llama_v2_7b_chat_quantized]"

Once installed, run the following simple CLI demo:

python -m qai_hub_models.models.llama_v2_7b_chat_quantized.demo

More details on the CLI tool can be found with the --help option. See demo.py for sample usage of the model including pre/post processing scripts. Please refer to our general instructions on using models for more usage instructions.

Export for on-device deployment

This repository contains export scripts that produce a model optimized for on-device deployment. This can be run as follows:

python -m qai_hub_models.models.llama_v2_7b_chat_quantized.export

Additional options are documented with the --help option. Note that the above script requires access to Deployment instructions for Qualcomm® AI Hub.

License

  • The license for the original implementation of Llama-v2-7B-Chat can be found here.

References

Community

Usage and Limitations

Model may not be used for or in connection with any of the following applications:

  • Accessing essential private and public services and benefits;
  • Administration of justice and democratic processes;
  • Assessing or recognizing the emotional state of a person;
  • Biometric and biometrics-based systems, including categorization of persons based on sensitive characteristics;
  • Education and vocational training;
  • Employment and workers management;
  • Exploitation of the vulnerabilities of persons resulting in harmful behavior;
  • General purpose social scoring;
  • Law enforcement;
  • Management and operation of critical infrastructure;
  • Migration, asylum and border control management;
  • Predictive policing;
  • Real-time remote biometric identification in public spaces;
  • Recommender systems of social media platforms;
  • Scraping of facial images (from the internet or otherwise); and/or
  • Subliminal manipulation