SUMO is an open source, highly portable, microscopic and continuous road traffic simulation package designed to handle large road networks. It allows for intermodal simulation including pedestrians and comes with a large set of tools for scenario creation.
Clone or download
Failed to load latest commit information.
.git_filters fixing python3 for keyword substitution, fix #4225 Jun 27, 2018
bin New initial commit Apr 10, 2018
build improving messaging on proj and fox finding, refs #3 Oct 14, 2018
data final logo icon Oct 21, 2018
docs new logo in docs, refs #2 Oct 18, 2018
src fixing departPos for disconnected routes, refs #2408 Oct 21, 2018
tests fixing the trip chain, refs #2408 Oct 21, 2018
tools making colors repeatable for testing. refs #4657 Oct 20, 2018
unittest Linking pthread in cmake files, refs #3 Oct 18, 2018
.appveyor.yml going back to cloning for appveyor Jul 18, 2018
.gitattributes adding the new logo Oct 18, 2018
.gitignore Added cmake_build to .gitignore Oct 15, 2018
.gitmodules New initial commit Apr 10, 2018
.travis.yml cleaning macos build, refs #3 Sep 18, 2018
AUTHORS added Lara Codeca to AUTHORS Jul 26, 2018
CMakeLists.txt fixing doc build and adding folders for msvc, refs #4228 Oct 13, 2018 using short project url, refs #22 Jul 3, 2018
ChangeLog New initial commit Apr 10, 2018
LICENSE adding first version for recommended Eclipse files, refs #4226 Jun 28, 2018 including java files in the dist, refs #3 Sep 24, 2018
Makefile.cvs New initial commit Apr 10, 2018 using short project url, refs #22 Jul 3, 2018 moving information to the right places, fix #4226 Jun 28, 2018 hopefully the last one for the macos autotools build, refs #3 Sep 18, 2018
sumo.doxyconf New initial commit Apr 10, 2018

Linux and MacOS Build Status Windows Build status

Eclipse SUMO - Simulation of Urban MObility

What is SUMO

"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.

Where to get it

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

Mailing List

To stay informed, we have a mailing list for SUMO. You can subscribe at Messages to the list can be sent to SUMO announcements will be made through the list; you can subscribe to this list at

Build and Installation

For Windows we provide pre-compiled binaries and CMake files to generate Visual Studio projects. Using Linux a simple "./configure && make" should be enough for the distributions, if you have installed all needed libraries properly. Using the repository checkout you need to issue "make -f Makefile.cvs" before "./configure && make" in order to run the autoconf utilities creating configure and the Makefiles. If configure does not find the libraries or includes needed, please check "./configure --help" for information on how to specify the paths needed.

For detailed build instructions have a look at our wiki.

Getting started

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 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.