Aerostack2

DocsCLI

Projects

List and download the Aerostack2 example projects with as2 project.

Authored by
  • @alvgaona

An example project is a repository with the launch files, configuration and mission scripts for one setup, such as a simulation or a real drone. as2 project downloads them into projects/ inside the Aerostack2 folder.

as2 project -l
as2 project -n gazebo
as2 cd gazebo
FlagWhat it does
-lLists the projects that can be downloaded, with their number and branch
-n <names>Downloads projects by name. Several names are separated by commas
-i <numbers>Downloads projects by their number in the list. Several are separated by commas
-vAdds each project's repository to the list. Put it before -l
-hPrints the help

Each project is cloned with git, on the branch given in the list. A project that's already in projects/ is skipped, so update it with git pull inside its folder.

The list

The list comes from the projects.repos file on Aerostack2's main branch, read from GitHub each time the command runs:

NumberProjectRepository
1gazeboproject_gazebo
2crazyflieproject_crazyflie
3px4_visionproject_px4_vision
4dji_osdkproject_dji_osdk

Other projects, like the multirotor simulator one, are cloned with git. Clone them into projects/ too, and as2 cd reaches them by name.

Needs internet and ping

Before anything else, the command checks the connection by pinging google.com. On a network that blocks ping, it reports that the internet connection isn't working, even when GitHub is reachable.

Last updated on November 3, 2026

On this page

Last updated on November 3, 2026