grok-1 README

The project's README from github.com/xai-org/grok-1. As one markdown file: README.md.

Grok-1

This repository contains JAX example code for loading and running the Grok-1 open-weights model.

Make sure to download the checkpoint and place the ckpt-0 directory in checkpoints - see Downloading the weights

Then, run

pip install -r requirements.txt
python run.py

to test the code.

The script loads the checkpoint and samples from the model on a test input.

Due to the large size of the model (314B parameters), a machine with enough GPU memory is required to test the model with the example code. The implementation of the MoE layer in this repository is not efficient. The implementation was chosen to avoid the need for custom kernels to validate the correctness of the model.

Model Specifications

Grok-1 is currently designed with the following specifications:

Downloading the weights

You can download the weights using a torrent client and this magnet link:

magnet:?xt=urn:btih:5f96d43576e3d386c9ba65b883210a393b68210e&tr=https%3A%2F%2Facademictorrents.com%2Fannounce.php&tr=udp%3A%2F%2Ftracker.coppersurfer.tk%3A6969&tr=udp%3A%2F%2Ftracker.opentrackr.org%3A1337%2Fannounce

or directly using HuggingFace 🤗 Hub:

git clone https://github.com/xai-org/grok-1.git && cd grok-1
pip install huggingface_hub[hf_transfer]
huggingface-cli download xai-org/grok-1 --repo-type model --include ckpt-0/* --local-dir checkpoints --local-dir-use-symlinks False

License

The code and associated Grok-1 weights in this release are licensed under the Apache 2.0 license. The license only applies to the source files in this repository and the model weights of Grok-1.

grok-1 (xai-org/grok-1)

Searching Database…

52.2K ·GitHub
What is this?Grok-1 is the 314B-parameter Mixture-of-Experts language model that xAI opened up; this repository holds the JAX example code for loading and running it.
Are the model weights included, or just the code?Just the code — the open weights are a separate download: you fetch them with a torrent client via the magnet link or straight from HuggingFace Hub.
How do I get it running once I have the weights?Place the downloaded ckpt-0 directory inside checkpoints, then run the test script: it loads the checkpoint and samples from the model on a test input.
Is the included code efficient?No — the MoE layer implementation is deliberately inefficient: it avoids custom kernels so the model's correctness could be validated easily.
Does the Apache 2.0 license cover both the code and the weights?Yes — the code and the Grok-1 weights are both under Apache 2.0, which applies to this repository's source files and the model weights of Grok-1.
Will this run on a regular GPU?Not really — at 314B parameters, the README requires a machine with enough GPU memory even just to test the model with the example code.
How big is the model, exactly?314B parameters in a Mixture-of-8-Experts architecture, with 2 experts used per token, 64 layers, 48 query heads (8 for keys/values) and a 6,144 embedding size.
How long a context can it handle?Up to 8,192 tokens of context, with text tokenized by a SentencePiece tokenizer whose vocabulary holds 131,072 tokens.
Does it support quantization or sharding?Yes — the model supports activation sharding and 8-bit quantization, and uses rotary embeddings (RoPE) for positional information.
Creator
xai-org
Size
1 MB
Stars
52.2K
Updated
CommitMar 19
Age
2y
Commits · 90 Days