{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "zju-real-polaris--run-gpu-experiment-over-ssh",
 "repo": "ZJU-REAL/Polaris",
 "repo_url": "https://github.com/ZJU-REAL/Polaris",
 "repo_slug": "zju-real-polaris",
 "title": "Run a GPU experiment on your lab server with a Voyage",
 "page_title": "How to run a GPU experiment on your lab server with a Voyage with Polaris",
 "summary": "Let an experiment Voyage plan, code, smoke-test and iterate over SSH under budget caps.",
 "who": "A researcher with a lab GPU server who wants an agent to run a study while they keep control of remote writes and spending.",
 "problem": "Setting up experiments, watching logs and fixing failures across many runs takes constant manual attention.",
 "outcome": "A tracked experiment run with streamed logs, live metric curves, generated figures and an audit trail, with the agent asking you a question when it is stuck.",
 "steps": [
  "Add your GPU server through the Experiment Lab with your SSH credentials, which Polaris stores Fernet-encrypted per user.",
  "Start an experiment Voyage and answer the intake questions about the study.",
  "Review the plan and the compute-budget check before approving any remote writes.",
  "Watch the smoke test, the streamed logs and the live metric curves in the console.",
  "Answer any question the run asks you, and review the generated figures and their VLM check when it finishes."
 ],
 "agent_prompt": "Using the Polaris repo at ZJU-REAL/Polaris, start an experiment Voyage on the GPU server <server name> for the study <study description>. Expected output: a completed run with metrics, logs and figures. Verify that every remote write was approved through the gate and that the budget caps were not exceeded.",
 "agents": [
  "any"
 ],
 "difficulty": "Advanced",
 "time": "2 hours",
 "basis": "readme",
 "caveat": "The README says the agent repairs failures under a time budget rather than a fixed retry count, so a stuck run will pause and ask you rather than finish on its own.",
 "category": "Research",
 "tags": [
  "Research"
 ],
 "lang": "python",
 "requirements": [
  "A computer where the Polaris desktop app can run (the README says new releases are desktop-only)",
  "A model source: an agent you already use, such as Claude Code, Codex or Gemini CLI, or a model API key",
  "For experiments: SSH access to a GPU server and your own SSH credentials",
  "A research direction or topic you want to explore"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The run uses your SSH credentials to reach a real GPU server, so only add a server you are authorized to use and review the command allow and deny lists before starting."
  }
 ],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/zju-real-polaris/run-gpu-experiment-over-ssh/",
 "md": "https://dedupedai.com/use-cases/zju-real-polaris/run-gpu-experiment-over-ssh/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/zju-real-polaris--run-gpu-experiment-over-ssh.json",
 "api_version": "v1"
}