Skip to main content

Overview

The Lyceum Cloud VS Code extension enables developers to execute Python code and Jupyter notebooks on cloud infrastructure without leaving their development environment. Get the power of GPU compute with the convenience of local development.
The VS Code extension is the recommended way to interact with Lyceum Cloud, providing seamless integration with your existing workflow.

Installation

Install the Extension

  1. Open VS Code
  2. Go to Extensions (Ctrl+Shift+X)
  3. Search for “Lyceum Cloud”
  4. Click Install on the official Lyceum Cloud extension

Authentication

The extension uses browser-based authentication for secure access to your account:
  1. Open any Python file (.py) or Jupyter notebook (.ipynb)
  2. Click the cloud icon in the editor toolbar
  3. You’ll be redirected to authenticate in your browser
  4. Return to VS Code - you’re ready to execute code on the cloud
Authentication tokens are securely stored and automatically refreshed by the extension.

Core Features

Code Execution

Execute Python scripts and Jupyter notebook cells directly on cloud infrastructure with real-time output streaming.

File Management

Upload local files to cloud storage, download execution results, and manage your cloud files through an integrated file browser.

Execution Monitoring

Track active runs, view execution history, monitor resource usage, and manage costs from within VS Code.

Usage Guide

Executing Code

  • Python Files
  • Jupyter Notebooks
Execute Python files on cloud infrastructure using any of these methods:Toolbar Button
  • Open a Python file
  • Click the cloud icon in the editor toolbar
Keyboard Shortcut
  • Use Ctrl+Shift+E to execute the current file
Command Palette
  • Open Command Palette (Ctrl+Shift+P)
  • Search for “Execute on Cloud”

File Operations

Right-click Upload
  • Right-click files or folders in VS Code Explorer
  • Select “Upload to Lyceum Cloud”
File Browser
  • View uploaded files in the “Lyceum Cloud Files” panel
  • Navigate through your cloud storage hierarchy
Download & Delete
  • Click download icon to retrieve files locally
  • Click trash icon to remove files from cloud storage

Execution Management

Monitor and manage your cloud executions directly from VS Code: Active Executions Panel (Ctrl+Shift+M)
  • View currently running workloads
  • Abort running jobs

Configuration

Extension Settings

Access through VS Code Preferences → Extensions → Lyceum Cloud:
SettingDescriptionDefault
API URLBase URL for Lyceum Cloud APIhttps://api.lyceum.technology/api

Commands Reference

CommandShortcutDescription
Execute on CloudCtrl+Shift+ERun current Python file or notebook cell
Upload FilesCtrl+Shift+UUpload selected files to cloud storage
Manage ExecutionsCtrl+Shift+MOpen execution management panel
Configure API TokenSet authentication token (manual override)
View HistoryShow execution history

Requirements and Imports

Code Organization

  • Specify dependencies in requirements.txt for automatic installation
  • Use relative file paths for better portability across environments

Troubleshooting

Token Problems
  • Re-authenticate by clicking the cloud icon in any Python file
  • Check that you’re signed in to the web dashboard
Network Issues
  • Verify internet connectivity and firewall settings
  • Check that VS Code can access external URLs
Upload Failures
  • Check file size limits (contact support for large file needs)
  • Verify network connectivity during upload
Permission Errors
  • Ensure proper authentication
  • Contact support if issues persist with file access

Need Help?

For additional support, reach out to our team at [email protected].