Documentation
Everything you need to integrate ARTE, configure simulations, and run automated testing.
Quickstart
Add .arte/simulation.yaml to your repository root or install the CLI tool.
# Install Upfreq CLI curl -fsSL https://get.upfreqrobotics.com/arte-cli | bash # Initialize ARTE in your robot workspace arte init --robot-urdf ./description/robot.urdf.xacro --ros-distro humble
GitHub Action & App Integration
Install the Upfreq GitHub App or add this workflow to run headless Isaac Sim tests on every PR:
name: ARTE Robotics Simulation CI
on:
pull_request:
branches: [main, develop]
jobs:
simulate:
runs-on: ubuntu-latest
steps:
- name: Checkout Codebase
uses: actions/checkout@v4
- name: Execute ARTE Simulation Matrix
uses: upfreq/arte-action@v1
with:
api_key: ${{ secrets.UPFREQ_API_KEY }}
config: .arte/simulation.yaml
timeout_minutes: 10arte.config.yaml Spec
version: "1.0" robot: name: "pallet_amr_v2" urdf_path: "description/urdf/amr.urdf" ros2_workspace: "ros2_ws" distro: "humble" simulation: backend: "isaac_sim_4_0" headless: true physics_frequency_hz: 60 environment_usd: "omniverse://upfreq/environments/warehouse_logistics_v4.usd" assertions: max_collision_count: 0 max_path_deviation_meters: 0.10 min_goal_success_rate_percent: 98.0 max_loop_latency_ms: 10.0
Isaac Sim Cloud Bridge
ARTE automatically loads your URDF/USD assets into dedicated NVIDIA Isaac Sim 4.0 headless instances with GPU-accelerated RTX raytracing and PhysX 5.
arte sim run --backend=isaac-sim --headless --gpu=rtx4090
ROS 2 CI/CD Runner
Native bindings for ROS 2 Humble, Iron, and Jazzy. Automatically detects navigation stacks, topic mappings, and control loops without manual bridging.
arte ros2 test --suite=navigation_stack_core --timeout=300s