mila-local-setup

Stars5

Forks1

UpdatedApril 14, 2026 at 19:40

Use this skill when the user asks about setting up their local machine to connect to the Mila cluster. Trigger phrases include: "How do I install WSL", "How do I install uv", "How do I install milatools", "What is milatools", "How do I configure milatools", "How do I set up my laptop for the cluster", "mila init", "uv tool install milatools", "curl uv install", "How do I install the mila CLI", "Windows setup for the cluster", "What tools do I need on my laptop", "SSH config", "SSH config setup", "authorized_keys".

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

mila-iqia

mila-iqia/skills

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Network and Computer Systems AdministratorsComputer and Mathematical Occupations·SOC 15-1244

File Explorer

2 files

SKILL.md

readonly

name	mila-local-setup
description	Use this skill when the user asks about setting up their local machine to connect to the Mila cluster. Trigger phrases include: "How do I install WSL", "How do I install uv", "How do I install milatools", "What is milatools", "How do I configure milatools", "How do I set up my laptop for the cluster", "mila init", "uv tool install milatools", "curl uv install", "How do I install the mila CLI", "Windows setup for the cluster", "What tools do I need on my laptop", "SSH config", "SSH config setup", "authorized_keys".
version	1.0.0
argument-hint	<wsl\|uv\|milatools>

Local Machine Setup for the Mila Cluster

This skill guides users through installing and configuring the tools needed on their local machine before connecting to the cluster: WSL (Windows only), uv, and milatools.

Base policies

At the start of each response, use the Skill tool with skill: "mila-base" to load and apply all shared policies before proceeding with the workflow below.

Reference documentation

Primary source: https://docs.mila.quebec/getting_started/ — sections "I'm using Windows, how do I install WSL?", "Install uv on your local machine", "Install milatools", and "Configure milatools".

Discover documentation

Use the WebSearch tool with this query to find the current URL of the primary source above:

site:docs.mila.quebec "__skill-mila-local-setup"

Use the URL from the search result in the WebFetch steps below. If the search returns no results, fall back to the hardcoded URL in "Reference documentation".

Workflow

Step 1: Identify the user's OS

Ask or infer the user's operating system:

Windows → guide through WSL first, then uv and milatools inside WSL.
macOS or Linux → skip WSL, go directly to uv and milatools.

If not mentioned, ask: "Are you on Windows, macOS, or Linux?"

Step 2: Fetch the documentation

Use the WebFetch tool to fetch https://docs.mila.quebec/getting_started/ and locate the sections relevant to the user's OS and question.

Step 3: Guide through the setup steps in order

Work through the applicable steps:

WSL 2 (Windows users only): WSL 2 is required (not WSL 1); the install command below installs WSL 2 by default on Windows 10 21H2 and later, and on all versions of Windows 11.

Open PowerShell and run wsl --install Ubuntu.
Restart the computer when prompted.
After restart, verify WSL 2 is active: in PowerShell, run wsl --list --verbose. The VERSION column should show 2 for Ubuntu. If it shows 1, run wsl --set-version Ubuntu 2 to upgrade.
WSL finishes setup; create a Linux username and password if prompted.
Open Ubuntu from the Start menu to get a Linux terminal.
Verify: run ls and curl --version in the WSL terminal.
All subsequent commands (uv, milatools, ssh) must be run inside the WSL terminal, not PowerShell or Command Prompt.

Install uv (all platforms, inside WSL on Windows): Use the WebFetch tool to fetch https://docs.astral.sh/uv/getting-started/installation/ for up-to-date installation instructions. Follow the steps for the user's platform (Linux/WSL, macOS, or Windows).

Install milatools:

uv tool install --upgrade milatools

Configure milatools with mila init:

Have the cluster username ready (received from IT after passing the onboarding quiz).
MFA must already be set up before running mila init (see the mila-account-setup skill).
Run mila init and follow the prompts: it sets up the SSH config, generates SSH keys, and copies the public key to the cluster's ~/.ssh/authorized_keys.

mila init

Step 4: Answer follow-up questions

Common questions:

"What is uv?" — A fast Python package manager and workflow tool, used both locally and on the cluster. It installs milatools and later manages Python environments for cluster jobs.
"Do I need to run mila init again if I reinstall?" — Only if the SSH config or keys are missing. Re-running mila init is safe.
"How do I update milatools?" — uv tool install --upgrade milatools (same install command).
"Can I use Cursor instead of VSCode?" — Yes, mila code supports Cursor and other compatible editors. See the mila-run-jobs skill for details.

Step 5: Point to the next skill

Once tools are installed and mila init has completed successfully, direct the user to the mila-connect-cluster skill to verify the SSH connection.

More from this repository

same repository

mila-account-setup

mila-iqia/skills

Use this skill when the user asks about obtaining a Mila account, enabling cluster access, or setting up Multi-Factor Authentication (MFA). Trigger phrases include: "How do I get a Mila account", "I need a Mila account", "How do I get cluster access", "How do I set up MFA", "How do I enable MFA", "I received a registration token", "registration email", "registrationcode", "I got an email from IT", "MFA setup", "I can't log in to the MFA portal", "How do I add a TOTP", "What is my cluster username", "How long does cluster access take", "IT onboarding quiz", "mfa.mila.quebec".

2026-04-145

mila-connect-cluster

mila-iqia/skills

Use this skill when the user asks about connecting to the Mila cluster via SSH, verifying the connection, entering an OTP, or troubleshooting connection failures. Trigger phrases include: "How do I connect to the cluster", "How do I SSH into the cluster", "ssh mila", "login.server.mila.quebec", "How do I verify my connection", "I can't connect", "connection refused", "permission denied", "host key verification failed", "OTP", "one-time password", "The login node banner does not appear", "Not prompted for OTP", "How do I install uv on the cluster", "I'm connected, what's next".

2026-04-145

mila-run-jobs

mila-iqia/skills

Use this skill when the user asks about running jobs or code on the Mila cluster. Trigger phrases include: "How do I run a job", "How do I run my first job", "How do I train a model", "mila code", "sbatch", "salloc", "VSCode on the cluster", "How do I use a GPU", "How do I request a GPU", "check available GPUs", "nvidia-smi", "How do I submit a batch job", "How do I run Python on the cluster", "How do I open VSCode on a compute node", "SLURM job", "squeue", "job queue", "slurm output file", "How do I stage data", "SLURM_TMPDIR", "How do I run PyTorch on the cluster", "interactive job".

2026-04-145

example-skill

mila-iqia/skills

An example skill that demonstrates the skill format. Use this as a template when creating new skills.

2026-03-265

name	mila-local-setup
description	Use this skill when the user asks about setting up their local machine to connect to the Mila cluster. Trigger phrases include: "How do I install WSL", "How do I install uv", "How do I install milatools", "What is milatools", "How do I configure milatools", "How do I set up my laptop for the cluster", "mila init", "uv tool install milatools", "curl uv install", "How do I install the mila CLI", "Windows setup for the cluster", "What tools do I need on my laptop", "SSH config", "SSH config setup", "authorized_keys".
version	1.0.0
argument-hint	<wsl\|uv\|milatools>

Local Machine Setup for the Mila Cluster

This skill guides users through installing and configuring the tools needed on their local machine before connecting to the cluster: WSL (Windows only), uv, and milatools.

Base policies

At the start of each response, use the Skill tool with skill: "mila-base" to load and apply all shared policies before proceeding with the workflow below.

Reference documentation

Discover documentation

Use the WebSearch tool with this query to find the current URL of the primary source above:

site:docs.mila.quebec "__skill-mila-local-setup"

Use the URL from the search result in the WebFetch steps below. If the search returns no results, fall back to the hardcoded URL in "Reference documentation".

Workflow

Step 1: Identify the user's OS

Ask or infer the user's operating system:

Windows → guide through WSL first, then uv and milatools inside WSL.
macOS or Linux → skip WSL, go directly to uv and milatools.

If not mentioned, ask: "Are you on Windows, macOS, or Linux?"

Step 2: Fetch the documentation

Use the WebFetch tool to fetch https://docs.mila.quebec/getting_started/ and locate the sections relevant to the user's OS and question.

Step 3: Guide through the setup steps in order

Work through the applicable steps:

WSL 2 (Windows users only): WSL 2 is required (not WSL 1); the install command below installs WSL 2 by default on Windows 10 21H2 and later, and on all versions of Windows 11.

Open PowerShell and run wsl --install Ubuntu.
Restart the computer when prompted.
After restart, verify WSL 2 is active: in PowerShell, run wsl --list --verbose. The VERSION column should show 2 for Ubuntu. If it shows 1, run wsl --set-version Ubuntu 2 to upgrade.
WSL finishes setup; create a Linux username and password if prompted.
Open Ubuntu from the Start menu to get a Linux terminal.
Verify: run ls and curl --version in the WSL terminal.
All subsequent commands (uv, milatools, ssh) must be run inside the WSL terminal, not PowerShell or Command Prompt.

Install milatools:

uv tool install --upgrade milatools

Configure milatools with mila init:

Have the cluster username ready (received from IT after passing the onboarding quiz).
MFA must already be set up before running mila init (see the mila-account-setup skill).
Run mila init and follow the prompts: it sets up the SSH config, generates SSH keys, and copies the public key to the cluster's ~/.ssh/authorized_keys.

mila init

Step 4: Answer follow-up questions

Common questions:

"What is uv?" — A fast Python package manager and workflow tool, used both locally and on the cluster. It installs milatools and later manages Python environments for cluster jobs.
"Do I need to run mila init again if I reinstall?" — Only if the SSH config or keys are missing. Re-running mila init is safe.
"How do I update milatools?" — uv tool install --upgrade milatools (same install command).
"Can I use Cursor instead of VSCode?" — Yes, mila code supports Cursor and other compatible editors. See the mila-run-jobs skill for details.

Step 5: Point to the next skill

Once tools are installed and mila init has completed successfully, direct the user to the mila-connect-cluster skill to verify the SSH connection.