Overview Version History Q & A Rating & Review
Octo
Run code seamlessly on remote servers with Octo .
👉 Learn more at project-octo.com help@project-octo.com
Features
🔑 Login to remote Octo servers using token & server address
🐳 Configure Docker images per server (e.g. python:3.11)
📦 Choose whether to install requirements.txt automatically
⚡ Run your current file directly on the selected server
🖥️ Manage multiple servers with a simple UI in the status bar
🎛 Configure resource limits per server:
GPU (none, all, 0, 0,1, UUID …)
RAM (e.g. 4g, 8g)
CPU (e.g. 2, 4)
Shared memory (e.g. 1g)
Quickstart
Install the Octo CLI on your remote server.In VS Code, open the status bar gear icon (⚙️) and select Octo: Settings.
Add a server:
Enter server name
Enter server address (e.g. http://192.168.0.172:5000)
Enter your Octo token
Select a Docker image (e.g. python:3.11)
Configure optional resources (GPU, RAM, CPU, Shared Memory)
Choose whether to install requirements.txt
Select the server you want to use.
Open any file in VS Code and press the play button ▶️ in the status bar.
Octo will automatically:
Log in to your server
Configure Docker with your chosen settings
Run your file remotely
How it works
Octo provides a smooth developer experience by combining the Octo CLI with an integrated VS Code workflow:
Authentication – octo login --token ... --server ...Configuration – set Docker image, requirements, and resource limits via octo configExecution – run your active file using octo run <file>
Requirements
Octo CLI must be installed on your server.
Docker must be available on the remote server.
Extension Settings
This extension contributes the following settings:
octo.servers: List of available Octo servers (with Docker image, GPU, RAM, CPU, shm config)octo.selectedServer: Name of the currently selected server
License
MIT
