Docs menu

Build

Robot software

The agent writes ROS 2 code, tests it against your twin in your world, and opens a pull request you can merge.

A robot software session is where the agent writes your ROS 2 code, tests it against a twin in a world, and hands it to you as a pull request on GitHub.

Before you start

  • A saved digital twin and a saved sim world.
  • Your software repository, given to the Upfreq GitHub App (see GitHub connection). Every repository the app can use, apart from your assets repository, shows on the Software tab of Assets.

Pick a twin, a world and a repository

Click New session and tell the agent you want to work on robot software. The agent lists your twins, worlds and repositories; pick one of each. The combinations you use are remembered in the repository, so next time you can pick one you used before instead of choosing again.

The agent writes and tests

Describe what the robot should do. The agent:

  1. works on a new branch;
  2. writes the ROS 2 code and builds it;
  3. runs it against the twin in the world, and checks it does what you asked;
  4. commits, pushes and opens a pull request.

"Using the cone-transfer robot in the textile mill, make it drive from the west dock down the aisle and stop at the end. Add a CI workflow that builds and tests it."

You watch it all happen in the sim view and the Data view, and you can step in at any time.

Review and merge

The Code tab, under the agent, shows the changes, the pull request and its CI checks. Read the diff, ask the agent for changes, or review the pull request on GitHub as usual. When the checks pass, press Merge.

In the sidebar, the session moves to In review when its pull request opens and to Done when it merges.