Deploy Physics Agent Service with Docker Compose

Deploy the physics-agent-service and the bundled OVRTX rendering API locally using Docker Compose. The physics service is CPU-only; the rendering sidecar uses the GPU.

When to Use

• Use when the user wants to run physics-agent-service locally with Docker Compose.
• Use when the user needs the bundled OVRTX rendering sidecar for physics classification.
• Use when the user wants to configure VLM provider credentials or run local smoke requests with optimizer flags.
• Use quickstart for a shorter first local POC, and use deploy-collection when running multiple Content Agents together.

Limitations

• The default stack owns host ports 8000 and 8001. Stop overlapping Material, Physics, Texture, or standalone OVRTX stacks before startup.
• The main service waits on OVRTX readiness; OVRTX is ready only when /health reports gpu_initialized: true.
• First build and first render are long-running operations. Return logs and health commands rather than holding an agent session open indefinitely.
• Keep secrets out of chat and commits. Tell the user to edit .env; do not ask them to paste keys.

Prerequisites