Upfreq Robotics

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: 10

arte.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