How to Build a Completely Air-Gapped Python Development Environment in VS Code (2026)

Developing software in a secure, air-gapped environment—whether due to high-security corporate firewalls, isolated virtual networks (VPCs), or remote off-grid locations—presents unique challenges. Modern IDEs and runtimes assume a persistent, high-speed connection to package registries, telemetry endpoints, and extension marketplaces.

When those connections are completely severed, a standard Python developer setup in Visual Studio Code falls apart. Extensions fail to install, syntax highlighters don’t load, and package installation commands throw socket timeouts.

In this deep-dive guide, we will step through constructing a 100% functional, high-performance, and air-gapped Python development environment in VS Code. We will cover extracting offline extension installers (VSIX), bootstrapping local Python runtimes, managing dependencies with offline Pip wheels, and locking down VS Code settings to stop unwanted background connections.

1. Sourcing and Preparing VS Code Extensions Offline

A functional Python workspace relies heavily on three core extensions: Python, Pylance (for IntelliSense and type checking), and Jupyter (for interactive data workspaces). In an air-gapped environment, you cannot use the built-in marketplace. Instead, you must pre-download the official .vsix packages.

Choosing the Correct Platform-Specific VSIX

Modern VS Code extensions contain compiled binaries (such as Pylance’s language server or Python’s debugger component). Downloading a “Universal” VSIX might result in missing platform binaries. You must grab the target matching your offline OS.

2. Installing VSIX Packages Offline

Once you have securely transferred your .vsix files across your network boundary (using an approved secure USB, SSH gateway, or internal repository mirror), you can install them using either the VS Code GUI or the command-line interface.

Method A: Command-Line Installation (Recommended)

Open your terminal inside the air-gapped machine and run:

# Install Python support
code --install-extension ms-python.python-2026.x.x-win32-x64.vsix

# Install Pylance language server
code --install-extension ms-python.vscode-pylance-2026.x.x-win32-x64.vsix

# Install Jupyter Notebook support
code --install-extension ms-toolsai.jupyter-2026.x.x-win32-x64.vsix

Method B: Graphical Installation

1. Open Visual Studio Code.
2. Open the Extensions view (Ctrl+Shift+X or Cmd+Shift+X).
3. Click the three dots (…) at the top right of the Extensions panel.
4. Select Install from VSIX… from the dropdown menu.
5. Choose your transferred file and click Install.

3. Setting Up an Offline Python Package Workflow

Installing Python itself is straightforward using offline installers (e.g., .exe for Windows or tarballs for Linux). However, fetching libraries like pandas, fastapi, or numpy without internet is where most developers struggle. The secret lies in pre-packaging your dependencies into local Wheel archives.

Step 1: Download Wheels on a Machine with Internet

Create a requirements.txt file listing all the libraries your project requires. Run this command on your internet-connected machine to download the platform-specific wheels into a local folder:

pip download -d ./offline_wheels -r requirements.txt

Step 2: Install Wheels in the Air-Gapped Environment

Copy the offline_wheels directory to your air-gapped machine and execute pip with the --no-index flag, pointing directly to your local folder:

pip install --no-index --find-links=./offline_wheels -r requirements.txt

This forces pip to ignore online PyPI indexes entirely, bypassing any network socket errors and installing directly from your pre-packaged wheel list.

4. Hardening VS Code for Air-Gapped Performance

Even in an air-gapped state, VS Code will repeatedly try to “phone home” to query update servers, upload telemetry, and synchronize settings. These constant failed background connections can cause system lag, CLI timeouts, and cluttered error logs.

Configure these strict rules inside your global settings.json (Ctrl+Comma -> search for Settings JSON) to stop background activity completely:

{
  "telemetry.telemetryLevel": "off",
  "update.mode": "none",
  "extensions.autoUpdate": false,
  "extensions.autoCheckUpdates": false,
  "workbench.settings.enableNaturalLanguageSearch": false,
  "python.analysis.diagnosticMode": "workspace",
  "python.analysis.useLibraryCodeForTypes": true,
  "redhat.telemetry.enabled": false
}

Summary and Recommended Reading

With these configurations applied, your air-gapped VS Code workspace is now highly optimized, fast, and completely safe from network-induced lag or dependency retrieval failures.

Related Reading on pratikpathak.com:

• Why I Swapped pyenv, pipx, and virtualenv for uv Tool Management — Learn how to speed up package management using modern tools.
• VS Code Offline Extensions Download: Complete 2026 Guide — Our foundational guide to offline VSIX files.
• Fix: VS Code C/C++ Extension Failed to Install Offline — How to resolve specific binary compiler dependencies offline.