README.md

---
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/`.