Break down large files into smaller chunks to upload them to repositories with limited upload sizes (like Git/GitHub's 100 MB hard limit).

Built with Odin.

odin build . -out:gshard -o:speed

Split a file into shards (default: 50 MB chunks):

gshard large_model.bin
# Creates large_model.bin.gshard/
#   ├── manifest.gshard
#   ├── chunk_0000.bin
#   ├── chunk_0001.bin
#   └── ...

Custom chunk size:

gshard large_model.bin --size=25000000   # ~25 MB chunks

Rebuild the original file from shards:

gshard rebuild large_model.bin.gshard
# Recreates large_model.bin

The manifest.gshard file is plain text:

<original filename>
<chunk count>
<chunk size in bytes>
<total file size in bytes>

A JS/TS library that fetches a .gshard directory from a static host (like GitHub Pages) and reassembles the file in-browser at runtime. Useful for serving large assets from static hosting without hitting file size limits.