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.Installation
Install the Extension
Install from VS Code Marketplace
Install from VS Code Marketplace
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X) - Search for “Lyceum Cloud”
- Click Install on the official Lyceum Cloud extension
Authentication
The extension uses browser-based authentication for secure access to your account:- Open any Python file (
.py) or Jupyter notebook (.ipynb) - Click the cloud icon in the editor toolbar
- You’ll be redirected to authenticate in your browser
- 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
- Use
Ctrl+Shift+Eto execute the current file
- Open Command Palette (
Ctrl+Shift+P) - Search for “Execute on Cloud”
File Operations
Upload Files to Cloud
Upload Files to Cloud
Right-click Upload
- Right-click files or folders in VS Code Explorer
- Select “Upload to Lyceum Cloud”
Manage Cloud Files
Manage Cloud Files
File Browser
- View uploaded files in the “Lyceum Cloud Files” panel
- Navigate through your cloud storage hierarchy
- 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:| Setting | Description | Default |
|---|---|---|
| API URL | Base URL for Lyceum Cloud API | https://api.lyceum.technology/api |
Commands Reference
| Command | Shortcut | Description |
|---|---|---|
| Execute on Cloud | Ctrl+Shift+E | Run current Python file or notebook cell |
| Upload Files | Ctrl+Shift+U | Upload selected files to cloud storage |
| Manage Executions | Ctrl+Shift+M | Open execution management panel |
| Configure API Token | — | Set authentication token (manual override) |
| View History | — | Show execution history |
Requirements and Imports
Code Organization
- Specify dependencies in
requirements.txtfor automatic installation - Use relative file paths for better portability across environments
Troubleshooting
Authentication Issues
Authentication Issues
Token Problems
- Re-authenticate by clicking the cloud icon in any Python file
- Check that you’re signed in to the web dashboard
- Verify internet connectivity and firewall settings
- Check that VS Code can access external URLs
File Operation Issues
File Operation Issues
Upload Failures
- Check file size limits (contact support for large file needs)
- Verify network connectivity during upload
- Ensure proper authentication
- Contact support if issues persist with file access
Need Help?
For additional support, reach out to our team at [email protected].

