README.md

metadata

title: NII Relay
emoji: 🛰️
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 6.10.0
app_file: app.py
pinned: false

NII Relay

A private message relay between your browser and shell daemons running inside no-SSH containers (e.g. on the NII cluster). The Space holds a queue of commands; daemons poll it, run the commands in persistent bash sessions, and post the output back.

Deploy

1. Create a private Space (SDK: Gradio). Upload app.py and requirements.txt. Keeping it private is the auth boundary — reaching it requires an HF token with access; there is no separate app-level secret.
2. Wait for the Space to build. The URL (https://huggingface.co/spaces/<you>/<name>) and its repo id (<you>/<name>) are what the daemon connects to.

Use

Open the Space, pick an online container (🟢), name a bash session, type a command, hit Run. Reuse a session name to keep its cd/env/venv; type a new name to open a fresh shell.

The daemon lives in ../daemon/.