Upgrade to Vega SDK 0.22

Vega Open Beta Q&A
1

Hello!

Now Ubuntu 22.04
$ kepler --version
0.21.4839

In plan - update to Vega SDK 0.22

See Installation info for 0.22 (looks like clean install, new script) but nothing about what to do with previous installation of 0.21.
Size of ~/kepler/sdk 8+Gb. Looks like new path must be ~/vega/sdk.
All commands via “kepler”. So, need some steps for uninstall and clean 0.21 or better keep it in parallel?
What about VSCode Vega SDK extention? It’s now compatible with both SDK versions or only new?

4

Hello @DJArty

Great question about upgrading from Vega SDK 0.21 to 0.22. Here’s what you need to know:

Upgrade Path:
Vega SDK 0.22 is designed to replace 0.21, not run in parallel. The new version uses a different installation path and structure.

Recommended Steps:
1. Uninstall Vega SDK 0.21

# Remove the old SDK directory
rm -rf ~/kepler/sdk
# Remove kepler command symlinks (if any)
sudo rm -f /usr/local/bin/kepler
sudo rm -f /usr/local/bin/vega
# Clean up environment variables
# Edit your ~/.bashrc or ~/.zshrc and remove any KEPLER_HOME or kepler-related PATH entries
nano ~/.bashrc # or ~/.zshrc
# Remove lines like: export KEPLER_HOME=~/kepler/sdk
# Remove lines like: export PATH=$PATH:$KEPLER_HOME/bin
# Reload shell configuration
source ~/.bashrc # or source ~/.zshrc

2. Install Vega SDK 0.22
Follow the clean installation steps for 0.22.
3. VSCode Vega Studio Extension
If VS Code was running during the Vega SDK installation, reload the app to recognize the Vega Studio extension:

  1. Open the VS Code Command Palette: Press Cmd+Shift+P
  2. Enter Reload Window and press Enter. VS Code reloads and recognizes the Vega Studio extension.
  • The latest extension version supports SDK 0.22

If You Need to Keep 0.21 Temporarily:
If you have active projects on 0.21 that you can’t migrate immediately:

  1. Rename the old SDK directory:
mv ~/kepler/sdk ~/kepler/sdk-0.21-backup
  1. Install 0.22 to the new path
  2. Switch between versions by updating your PATH manually (not recommended for daily use)

You can follow this link if you encounter any issues during the upgrade.

Warm regards,
Ivy

1 Like