cpuai's picture
Install complete Linux VS Code + AHP MCP development workstation 2026-10-12
c12eb19 verified
|
Raw History Blame Contribute Delete
1.83 kB
---
title: AHP Development Workstation
emoji: 🛠️
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
fullWidth: true
short_description: VS Code, AHP MCP bridge and Linux development tools
---
# AHP Development Workstation
This Space runs a Linux development environment with separate VS Code-compatible browser IDE (code-server), the official Microsoft `code agent host` standalone CLI, an unchanged AhpMcpBridge MCP endpoint and HTTP downloads.
Paths:
- `/ide/`: browser IDE (password required).
- `/health`: bridge health.
- `/downloads/`: intentionally public downloads.
- `/<original-mcp-route>`: original Streamable HTTP MCP transport (Bearer API key required).
All services share the same Linux filesystem. AHP listens on 127.0.0.1:7242 internally and must not be publicly exposed. MCP listens on 127.0.0.1:5100 internally. Nginx publishes one port (7860) for Hugging Face.
**Mandatory Space secrets:** `CODE_SERVER_PASSWORD`, `MCP_API_KEY`. Startup refuses to run without either. Do not add secrets to the Dockerfile, README or repository.
Toolchain includes .NET 10 SDK, ASP.NET Core 8 runtime, Node.js 22, Python 3, GCC/Clang, Git, FFmpeg, fonts, Playwright/Chromium, edge-tts, and Hyperframes. The science-video skill is under `/opt/workstation/skill/`; Windows PowerShell stage scripts are retained as examples only. On Linux use Bash and Python commands described in `SKILL.md`.
**Persistence:** Hugging Face Docker Spaces' writable filesystem may be ephemeral across rebuilds and restarts. Back up `/home/coder/workspace`, `/home/coder/data`, and AI agent authentication state externally. The login for GitHub Copilot/Claude is not automatically provisioned.
This image contains editor access and full shell execution; it must be treated as an internet-facing development machine, not a public demo.