Twinkle Installation

Wheel Package Installation

You can install using pip:

pip install 'twinkle-kit'

Installation from Source

git clone https://github.com/modelscope/twinkle.git
cd twinkle
pip install -e .

Docker Image

You can also use our pre-built Docker image:

modelscope-registry.cn-hangzhou.cr.aliyuncs.com/modelscope-repo/modelscope:twinkle-0.3.0

Client Installation

If you need to use Twinkle’s Client for remote training, you can use our one-click installation script:

# Mac or Linux
sh INSTALL_CLIENT.sh
# Windows, Open with PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
.\INSTALL_CLIENT.ps1

This script will download or utilize conda to create a virtual environment called twinkle-client, which can be directly used for remote training.

Megatron Dependencies

If you need to install Megatron-related dependencies, you can use the following script:

sh INSTALL_MEGATRON.sh

Supported Hardware