Asimovo Local Client

Find instructions on how to work on your laptop using the Asimovo Local Client to connect your local environment to the platform. For many people this will be where you do 100% of your development.

In many cases you will prefer to develop your project locally while using the Asimovo platform to collaborate and run simulations. Working locally will mean you have access to all native robotics tools, some of which are not available via a web interface. Tools like MoveIt Setup Assistant and RViz are only available locally.

Working locally also means you do not need to use cloud credits to run your workspaces. You can use your laptops compute power instead.

To do work locally you need a Linux machine. Ubuntu 22.04 (or newer, with 22.04 best tested) with at least a Nvidea GPU, >50Gb free disk space and at least 16Gb of RAM.

Follow these steps to download and set up the Asimovo Client:

1. Download the Asimovo Client Script: From your project's overview page, locate the welcome message and on click the download button to get the Asimovo Client script as a tarball.

1. Locate the Downloaded File: Once downloaded, find the file named asimovo_client.tar.gz in your system.

2. Extract the tarball: Open a terminal and run the following command to extract the file:

   tar -xzf asimovo_client.tar.gz

3. Move to the directory where you have extracted the tarball:

   cd ~/asimovo

   If you have extracted the tarball in a different directory than home, adapt the command accordingly.

4. Install dependencies: To install all necessary dependencies for Ubuntu, run the following command:

   ./install_ubuntu_deps.sh

5. Reboot if required: If prompted by the script, reboot your system to apply the changes.

6. Start the Asimovo client: Run the following command to start the client:

   ./asimovo.sh

7. Log in: If you aren’t already logged in to the portal, a browser window will open displaying a login form. Asimovo Client (v1.28.5+k3s1) for cluster: platform For Your Information: bundled version of K3S is: v1.28.5+k3s-6676d730 Opening in existing browser session.

8. Authentication success: After logging in successfully, the browser window will display the following message:
9. Return to the terminal: When the connection is successful, the script displays the following message: Waiting for ready state of new Asimovo location: 'your_own_hostname' ·····****************# Asimovo location online!

10. Open the Asimovo portal and create a workspace to start working locally:

    • In a browser, go to https://platform.asimovo.com

    • Go into a project within which you wish to create workspaces for your local client

    • Navigate to "My workspaces"

    • Select the tab named as your hostname

    • Create a workspace. This will be created in /.asimovo/usermounts

Troubleshooting

If you encounter issues, you can run the script in debug mode using:

./asimovo.sh -vv -f

If a hard reset is needed, run :

./cleanup_asimovo.sh

This will remove all configurations and data related to the Asimovo client, including the mounted folder where workspaces are stored: /.asimovo/usermounts. Warning: Running this command will delete all client workspaces.