README.md

metadata

title: Visual Studio Code
emoji: 💻
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: true
license: mit
short_description: An online VS Code on the Web, now equipped with toolchains.

💻 VS Code on the Web IDE with Auto Backup

This Space runs VS Code on the Web with a full developer toolchain, ready for mega collaboration:

🔧 Installed Developer Tools

• Python 3.12: pip, virtualenv, JupyterLab, black, flake8, mypy, IPython
• C/C++: gcc, g++, clang, lld, cmake, ninja, valgrind, gdb
• Rust: stable toolchain via rustup
• Go: latest stable
• Java: OpenJDK 17
• C#/.NET: .NET SDK 8.0
• Node.js 20: npm, yarn, pnpm, TypeScript, ts-node, nodemon
• CLI Productivity Tools: git, git-lfs, htop, fzf, ripgrep, silversearcher-ag, rsync, sqlite3, tree, jq, net-tools

---

🔒 Security Hardening

• Bash history is disabled globally:
  All interactive shells inside this container are launched with:

  • HISTFILE unset
  • HISTSIZE=0, HISTFILESIZE=0
  • .bash_history linked to /dev/null

  👉 This ensures no command history is ever logged to disk, protecting sensitive tokens and commands.

---

🗂️ Auto Backup

Every 45 minutes, /workspace is automatically uploaded to your Hugging Face repo defined in environment variables:

• BACKUP_REPO → target repo (e.g., username/my-backup)
• HF_TOKEN → your Hugging Face API token

⚠️ On first launch, the backup service will attempt to restore /workspace from your BACKUP_REPO. Make sure the repo exists. If empty, a fresh workspace will be created.

Backups are uploaded with a cache-safe method to avoid LFS errors.

---

🚀 Usage

1. Set secrets in Space Settings:

   • BACKUP_REPO
   • HF_TOKEN

   Notes:

   • Leaving either secret empty will disable Auto Backup and restore.
   • All files are wiped on Space restart. Using either persistent storage space or the Auto Backup Service is highly recommended.

2. Launch the Space → Access VS Code at http://<space-url>

   • No authentication by default (--auth none).
   • Optional: enable a password via environment variables if desired.

3. Work normally — backups run in the background every 45 minutes.

---

⚠️ Important Notes

1. I STRONGLY ADVISE against putting credentials directly into the IDE. If you must use them, remove them immediately after use to prevent accidental leaks and misuse.
2. All command history is disabled for your safety — but always treat the /workspace folder contents as sensitive.
3. If you plan to duplicate this Space for backups, DO NOT make the Space public! Environment variables in Hugging Face Spaces can be exposed to anyone with container access (e.g., via env, printenv, or process inspection).
4. I am NOT responsible for any damages caused by leaked passwords/tokens from this Space — so take extreme care with your credentials.

ℹ️ Additional Notes

• Since this Space is hosted remotely (not local), you may experience some latency when performing actions.
• This IDE is designed for collaborative coding — so feel free to invite friends and enjoy a feature-packed online coding adventure! 🚀