shard-llms 0.2.10

Shard Large Language Models

🧠 Shard LLMs: Unleashing the Power of Large Language Models

🌟 Introduction

Welcome to the Shard LLMs project! This repository provides tools and techniques for efficiently managing and deploying Large Language Models (LLMs) through sharding. By breaking down these massive models, we can overcome resource constraints and unlock their full potential.

🚀 Why Shard LLMs?

Sharding is a game-changer for working with LLMs. Here's why:

1. 💾 Memory Optimization: Fit billion-parameter models across multiple GPUs.
2. ⚡ Speed Boost: Parallel processing for faster training and inference.
3. 📈 Scalability: Effortlessly scale to larger models and datasets.
4. 💰 Cost-Effective: Maximize hardware efficiency and reduce training costs.
5. 🔄 Enhanced Throughput: Process more requests simultaneously.
6. 🛡️ Fault Tolerance: Improve system resilience with distributed processing.
7. 🔧 Flexibility: Train large models on limited hardware or scale to massive clusters.
8. 🌐 Optimized Communication: Reduce overhead between model components.

🛠️ Getting Started

First Step: Set the environment variable:

You need to set up your Hugging Face token as an environment variable to use the Shard-Any-LLMs package with Hugging Face Hub functionality.

1. Obtain Your Hugging Face Token

1. Go to the Hugging Face website
2. Log in to your account
3. Navigate to your profile settings
4. Find and copy your API token

2. Set the Environment Variable

Depending on your operating system, use one of the following methods to set your HuggingFace token:

For macOS and Linux: Open a terminal and run:

export HF_TOKEN=your_token_here

To make this permanent, add the line to your shell configuration file (e.g., ~/.bashrc, ~/.zshrc):

echo 'export HF_TOKEN=your_token_here' >> ~/.bashrc

Then, restart your terminal or run source ~/.bashrc.

For Windows: In Command Prompt, run:

setx HF_TOKEN your_token_here

🔬 Sharding a Model

There are two ways to use Shard LLMs: via command-line interface or by running the Python script directly.

Method 1: Command-Line Interface (Recommended)

After installing the package, you can use the shard_llms command:

shard_llms --model_name MODEL-ID --save_dir SAVE_DIRECTORY --max_shard_size SHARD_SIZE --token HF_TOKENS

Example: 

shard_llms --model_name meta-llama/Meta-Llama-3.1-8B-Instruct --save_dir ~/sharded_model --max_shard_size 2GB

Since I have already set up the environment variable, I ignored the --token flag.

Method 2: Running the Python Script

Installation

Clone the repository:

# SSH
git clone [e-mail]:yzm1205/Shard-Any-LLMs.git

# HTTPS
git clone https://github.com/yzm1205/Shard-Any-LLMs.git

Prerequisites

Ensure you have all the necessary dependencies:

pip install -r requirements.txt

This will install:

• python-dotenv==1.0.1
• transformers==4.44.2
• torch==2.4.1

RUN

You can run the Python script directly:

python sharding_model.py \
  --model_name MODEL-ID \
  --save_dir SAVE_DIRECTORY \
  --max_shard_size SHARD_SIZE \
  --token YOUR_HUGGINGFACE_TOKEN

Example:
Let's shard the LLaMA-3.1-8B-Instruct model as an example:

python sharding_model.py \
  --model_name meta-llama/Meta-Llama-3.1-8B-Instruct \
  --save_dir ~/sharded_model \
  --max_shard_size 2GB \
  --token YOUR_HUGGINGFACE_TOKEN

Note: When using either method, ensure that you have set up your Hugging Face token as an environment variable (HF_TOKEN) as described in the "First Step" section. Otherwise, replace YOUR_HUGGINGFACE_TOKEN with your actual HuggingFace token.

🔧 Loading a Sharded Model

To use your sharded model, you can load it using HuggingFace's AutoModelForCausalLM and AutoTokenizer:

import torch
from transformers import AutoTokenizer, AutoModelForCausalLM

model_dir = "./sharded_model/Meta-Llama-3.1-8B-Instruct/"
#optional: ignore, if HF_TOKEN is set else:
hf_token = "YOUR_HUGGINGFACE_TOKEN"

model = AutoModelForCausalLM.from_pretrained(
    model_dir,
    trust_remote_code=True,
    torch_dtype=torch.float16,
    token=hf_token
)

tokenizer = AutoTokenizer.from_pretrained(
    model_dir,
    trust_remote_code=True,
    token=hf_token
)

💡 Pro Tip: You can also use other methods to load sharded models, such as the pipeline API from Transformers.

🤝 Contributing

We welcome contributions! If you have ideas for improvements or new features, feel free to open an issue or submit a pull request.

🙏 Acknowledgments

• HuggingFace for their amazing Transformers library
• The open-source AI community for continuous inspiration and support

Happy sharding! 🎉