Starting kit for the REAL2022 competition on Robot open-Ended Autonomous Learning.
The REAL Competition is an online challenge, open to everyone, aimed at building a robot controller that autonomously learns to interact with an environment in an open-ended way, without being instructed specifically for a task.
Competition starts on September 12th 2022 and will last up to end of September 2023.
REAL 2022 will be officially launched during the ICDL 2022 conference.
Pre-requisites: Python, Git, Conda (Anaconda or Miniconda) and Docker
All software has been tested on Ubuntu 18.04 and 20.04.
- Clone this repository:
git clone https://github.com/emilio-cartoni/REAL2022_starter_kit.git
cd REAL2022_starter_kit- Create a conda environment named "real_robots" from the provided
environment.yml
conda env create -f environment.yml
This could last a while as many libraries that are needed by the baseline will be installed, including Tensorflow.
(It is possible to reduce the libraries in the environment if you do not want to run the baseline).
If you want to install the environment on a MAC, you can try the environment_MAC.yml instead.
- Activate the real_robots conda environment
conda activate real_robots
- Launch the local evaluation:
python local_evaluation.py
The default values will only launch a short evaluation, edit local_evaluation.py to launch full evaluations and customize the options.
To make submissions to the challenge, it is necessary to create and submit a docker container, which will contain all the dependencies to run your submission and the simulation.
- Launch the image build to create a docker image for your submission.
(The first build may take a long time since it will have to recreate the environment inside the container - subsequent build will be faster due to docker caching mechanism)
build.sh - (Optional) You can launch your docker image locally, to check it is working:
docker run -it real2022submission:latest /root/miniconda3/bin/conda run -n real_robots python docker_evaluation.py - Go to EvalAI Submit page and follow the instructions there to submit the image as a submission for the REAL2022 competition.
For further information, check our Wiki.
In particular, if you want to know more about:
- the environment, see here
- the options available for the environment and the simulation, see here
- how to develop your own controller and the docker image build, see here
- to know more about the baseline, see here
... or see the FAQ for common questions or errors.
Feel free to contact us for any problems or additional questions on the competition.
You can post them as an issue here on Github, or post on EvalAI forum or, if you prefer, directly contact the organizers via mail.
Best of Luck 🎉 🎉