---
title: VS Code on Web
emoji: 💻
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
app_port: 7860
---

# VS Code on Web - Hugging Face Spaces

This Space deploys VS Code in your browser using code-server with persistent storage via Hugging Face Datasets.

## Features

- 🌐 VS Code running in your browser
- 💾 Persistent storage using Hugging Face Datasets
- 🐍 Pre-installed Python 3 and pip
- 📦 Node.js and npm included
- 🛠️ Build tools and common utilities
- 🔒 Password-protected access
- 🤖 AI coding assistant (Continue) with Gemini support

## Setup

### 1. Create a Hugging Face Dataset

Create a new private dataset on Hugging Face to store your VS Code data:
https://huggingface.co/new-dataset

### 2. Configure Environment Variables

In your Space settings, add these secrets:

- `HF_TOKEN`: Your Hugging Face access token (with write permissions)
- `HF_DATASET`: Your dataset name (e.g., `username/vscode-data`)

### 3. Access Your VS Code

Once deployed, access your VS Code instance through this Space. The default password is `huggingface`.

## How Persistence Works

The startup script automatically:
- Downloads your saved workspace, settings, and extensions from the HF dataset on startup
- Auto-saves every 5 minutes while running
- Saves all data when the Space shuts down

**Persisted data includes:**
- VS Code settings and configuration
- Installed extensions
- Workspace files and folders
- Extension settings (including API keys)

## Configuration

- **Port**: 7860
- **Default Password**: `huggingface` (change in Dockerfile)
- **Workspace Directory**: `/home/coder/workspace`
- **Auto-save interval**: Every 5 minutes

## Installed Tools

- Git
- Python 3 with pip
- Node.js with npm
- Build essentials (gcc, g++, make)
- Text editors (vim, nano)
- Hugging Face CLI
- Continue extension (supports Gemini, GPT-4, Claude, etc.)

## Notes

- Without `HF_TOKEN` and `HF_DATASET` set, the Space runs without persistence
- The first startup takes longer as it sets up the environment
- Large workspaces may take time to sync
- Your data is stored in your private HF dataset and not accessible to others