CLI Reference

Install megagem from this server — the wheel here is always the exact version the platform runs.

pip install megagem --extra-index-url https://megagem.hrvt.dev/simple/

uv add megagem --index https://megagem.hrvt.dev/simple/

Authenticate with the platform. Creates or updates credentials in ~/.config/megagem/credentials.

megagem auth --server https://megagem.example.com

You'll be prompted to go to Account → API tokens, create a token, and paste it.

Upload a bot version to the server. Accepts a single .py file, a .zip archive, or a directory (zipped automatically).

# Single file
megagem push main.py --name my-bot

# Directory (zipped automatically — supports helpers, weights, etc.)
megagem push my_bot/ --name my-bot --activate

# Pre-made zip
megagem push my_bot.zip --name my-bot --activate

The --activate flag sets the version as your active bot after validation passes. The command polls for validation and reports the result.