Skip to content
Eclipse 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.
C++ Python C Java CMake C# Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.git_filters Happy New Year to sumo Jan 23, 2019
bin removing accidentally committed file, refs #22 Jul 30, 2019
build updating version and submodules, refs #563 Aug 20, 2019
data fixing xsd Aug 23, 2019
docs trying to fix line-ending issue Feb 25, 2019
src removing generated file, refs #22 Aug 24, 2019
tests parallelizing netedit tests, refs #21 Aug 23, 2019
tools switching to cmake for the build history, refs #3 Aug 23, 2019
unittest fixing style, refs #22 Aug 15, 2019
.appveyor.yml going back to cloning for appveyor Jul 18, 2018
.gitattributes trying to fix line-ending issue Feb 25, 2019
.gitignore filtering visual studio code files Aug 22, 2019
.gitmodules adding saga module, thanks to Lara Codeca Aug 19, 2019
.travis.yml removing outdated build file and redundant license, refs #3 Jul 8, 2019
AUTHORS updated authors Mar 13, 2019
CMakeLists.txt do not deliver doxygen, refs #2 Aug 22, 2019 reformulating contribution guidelines concerning external modules, refs May 7, 2019
ChangeLog New initial commit Apr 10, 2018
LICENSE adding first version for recommended Eclipse files, refs #4226 Jun 28, 2018 removing outdated build file and redundant license, refs #3 Jul 8, 2019
Makefile.cvs New initial commit Apr 10, 2018 using short project url, refs #22 Jul 3, 2018 People don't like backticks, refs #2 Jul 4, 2019 unfixing release info, refs #563 Aug 20, 2019
sumo.doxyconf merging from master Jan 15, 2019

Linux and MacOS Build Status Windows Build status Repo Size

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


To stay informed, we have a mailing list for SUMO you can subscribe to. Messages to the list can be sent to SUMO announcements will be made through the list; you can subscribe to as well. For further contact information have a look at the wiki page.

Build and Installation

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

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

    sudo apt-get install cmake python g++ libxerces-c-dev libfox-1.6-dev libgdal-dev libproj-dev libgl2ps-dev swig
    cd <SUMO_DIR> # please insert the correct directory name here
    export SUMO_HOME="$PWD"
    mkdir build/cmake-build && cd build/cmake-build
    cmake ../..
    make -j$(nproc)

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.

We welcome patches, pull requests and other contributions! For details see our contribution guidelines.


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.

You can’t perform that action at this time.