"Simulation of Urban MObility" (SUMO) is an open source, highly portable, microscopic traffic simulation package designed to handle large road networks and different modes of transport.

It is mainly developed by employees of the Institute of Transportation Systems at the German Aerospace Center.

You can download SUMO from SourceForge via our downloads site.

As the program is still under development and is extended continuously, we advice you to use the latest sources from our GitHub repository. Using a command line client the following command should work:

    git clone --recursive https://github.com/eclipse/sumo

To stay informed, we have a mailing list for SUMO. You can subscribe at https://dev.eclipse.org/mailman/listinfo/sumo-user. Messages to the list can be sent to [email protected]. SUMO announcements will be made through the [email protected] list; you can subscribe to this list at https://dev.eclipse.org/mailman/listinfo/sumo-announce.

For Windows we provide pre-compiled binaries and CMake files to generate Visual Studio projects. If you want to develop under windows, please also clone the dependent libraries using

    git clone --recursive https://github.com/DLR-TS/SUMOLibraries

Using Linux you should have a look whether your distribution already contains sumo. There is also a ppa for ubuntu users and a open build service instance. If you want to build yourself, the steps for ubuntu are:

    sudo apt-get install cmake libxerces-c-dev libfox-1.6-dev libgl1-mesa-dev libglu1-mesa-dev libgdal-dev libproj-dev
    mkdir build/cmake-build && cd build/cmake-build
    cmake ../..
    make -j8

For detailed build instructions have a look at our wiki.

To get started with SUMO, take a look at the docs/tutorial and examples directories, which contain some example networks with routing data and configuration files. There is also user documentation provided in the docs/ directory and on the homepage.

Please use for bugs and requests the GitHub bug tracking tool or file them to the list [email protected]. Before filing a bug, please consider to check with a current repository checkout whether the problem has already been fixed.

SUMO is licensed under the Eclipse Public License Version 2. For the licenses of the different libraries and supplementary code information is in the subdirectories and the wiki.