There are two versions of the Developer platform: Cloud and Local.
Below are the instructions for each setup, along with how to get started with a license.
Licensing
To utilize the SWARM RDS Platform, you will need to purchase a license.
You can either contact one of the individuals listed below or go to our website to request a license.
- Tyler Fedrizzi - tylerfedrizzi@codex-labs-llc.com
- Alex Zhang - alex@codex-labs-llc.com
Getting Started
SWARM RDS Consists of a client application that you can use to submit simulations to the SWARM RDS system. To go with this application, there is a Python-based repository that allows you a development workspace through which you can quickly build new algorithms, save different vehcile profiles and much more.
Requirements
The following list are the requirements you will need to have isntalled to be able to use the SWARM RDS Platform.
- Required A working version of Python version 3.8 or greater. Check Supported Software
- Required Git (If on Windows, installing Git will install the extension in Powershell - Install Git (Windows))
- (Optional) A good development environment. (We recommend Visual Studio Code)
- (Optional) If you are on Windows, we recommend installing Anaconda and linking that with Powershell.
Install the SWARM RDS Client Application
You can download our client application from the following link:
Download the SWARM RDS Python Repository
Using your development environment or the command line inside of Visual Studio Code, clone our client repository.
Next, you will want to create a new virtual environment with your choice of environment manager, such as Anaconda or pyenv.
Install all dependencies with the following command:
Scroll down to see additional instructions for the Cloud and Local editions of the SWARM RDS Platform.
Recommended Python Installation
Windows Users
Installing Python on Windows can be slightly complex. The recommended method is to install the Python
application, along with Visual Studio Code. This will allow you to easily install the required packages
and use Python through the terminal in VS Code.
The recommended method is to install Python via Micrsoft store or to download it Here.
Once you have installed Python, we recommend installing Anaconda to manage dependencies. You can download Anaconda Here.
Once you have installed Anaconda, you first need to create a new conda virtual environment in Powershell. To do this, run the following command: conda --create swarmrds. More commands are here: Conda Cheat Sheet. You can then activate this environment with the following command: conda activate swarmrds.
Once you have activated the environment, you will need to go to where you installed our python repository. In visual studio code, open our repository and then create a new terminal. Then, you can then install the required packages with the following command: conda install --yes --file requirements.txt.
Mac Users
The recommended method is to install Python via a tool like brew or to install the Developer Command Line tools. Please install the python packages using the above method.
Linux Users
The recommended method is to install Python apt with sudo apt-get install -y python3-dev python3-pip. Please install the python packages using the above method.
Local Edition Only (ie. you are not using the cloud!)
If you have a copy of our Docker Container
The Local edition of the SWARM Simulation Platform is still easy to get started and set up.
What you'll need:- Install NVIDIA Docker on your host platform (we currently only support Linux) NVIDIA Docker
- The lastest NVIDIA Drivers for your specific GPU (>= Version 515)Download NVIDIA Drivers
Installing SWARM Core
Next, we will install the SWARM Container to the Docker host.
Using the link provided, download the tar file that contains the container. (Please not this container may be 10 - 15 GB, so please ensure you have space on your system!)
Next, we will load the container. In the same directory where you downloaded the tar file, run the following command:
This will take several minutes depending on the size of the container.
Once completed, you can then run the following command to view the name of the container.
(Optional) If you have a Proxy Network
If you are on a Proxy network, you will need to set the proxy settings for the container. To do this, run the following command:
Adding these environment variables will enable the container to access the internet through the proxy network. Please see the README in the Python Repository for more information.
That's it! You are ready to rock and build your awesome autonomous system! Visit the Getting Started guide or the API Documentation to get started!