deploy-physics-agent-brev

name	deploy-physics-agent-brev
description	Deploy or smoke-test the Physics Agent with Brev-hosted dependency endpoints. Use when the user asks to test physics agent on Brev, deploy physics agent with Brev, use RTX/L40S for rendering and A100/H100-grade GPU for VLM, run a Brev hybrid physics-agent test, recreate the Brev physics-agent deployment, or validate service-side refine with a registered provider. This workflow keeps the main pipeline local and uses Brev port-forwards to reach OVRTX and Qwen-family VLM endpoints.
version	0.1.1
author	NVIDIA Content Agents
tags	["content-agents","physics-agent","brev","ovrtx","vlm","deployment"]
tools	["Shell","Docker","Python","curl","Filesystem","brev","ssh"]
compatibility	Requires Brev CLI access, a remote RTX/L40S-class render GPU for OVRTX, an A100/H100-class VLM endpoint, local port-forwards, and Physics Agent provider credentials.

Deploy Physics Agent With Brev

When to Use

Use the credit-conscious hybrid path:

• Local machine runs the physics-agent pipeline.
• Brev wu-pa-render runs standalone OVRTX on an RTX GPU. Prefer AWS g7e.2xlarge / RTX PRO Server 6000 for fast validation, or AWS g6e.xlarge / L40S when lower cost matters more than cold-start latency.
• Brev wu-pa-vlm-a100 or wu-pa-vlm-h100 runs an OpenAI-compatible Qwen endpoint. Use Denvr A100 80 GB for the lower-cost validated path, or Hyperstack H100 for the validated Qwen3.5 35B NIM path.
• Local port-forwards expose RENDER_ENDPOINT=http://localhost:8001 and PA_VLM_NIM_BASE_URL=http://localhost:8003/v1.

Limitations

• Keep provider credentials in .env or remote env files with restrictive permissions; never print or commit them.
• Prefer local port-forwards for this hybrid path; do not assume Brev instance-to-instance networking is available.
• Physics Agent service /refine requires the tuning dependencies, an OvPhysX runtime, and a registered chat/VLM provider configured through PA_REFINE_BACKEND, PA_REFINE_MODEL, and that provider's credential.
• Delete GPU nodes after validation unless the user asks to keep them.

Prerequisites

• Brev CLI access and SSH-ready render and VLM nodes.
• Docker, NVIDIA Container Toolkit, and writable storage on each remote node.
• Local Physics Agent environment with provider credentials required by the selected config.

Instructions

1. Use brev-cli for generic Brev inventory, dry-run, create, port-forward, stop, delete, and cleanup guardrails.
2. Create or reuse the Brev render node, then validate OVRTX health and render.
3. Create or reuse the VLM node, then validate model listing and image chat.
4. Set local Physics Agent render, VLM, and LLM environment variables.
5. Run the local pipeline with the forwarded endpoints, then clean up nodes and port-forwards.

Credit Safety

Start with:

brev --version
brev healthcheck
brev ls --json
python scripts/brev_agent_services.py --service physics --preset hybrid --render-gpu-name RTX --vlm-gpu-name A100

Reuse existing instances when possible. Run before real creation unless the user already confirmed the exact spend.