CityFlow

A Multi-Agent Reinforcement Learning Environment for Large Scale City Traffic Scenario.
https://github.com/cityflow-project/CityFlow

Category: Consumption
Sub Category: Mobility and Transportation

Keywords

multiagent-reinforcement-learning multiagent-systems traffic-signal-control traffic-simulation

Last synced: about 14 hours ago
JSON representation

Repository metadata

A Multi-Agent Reinforcement Learning Environment for Large Scale City Traffic Scenario

• Host: GitHub
• URL: https://github.com/cityflow-project/CityFlow
• Owner: cityflow-project
• License: apache-2.0
• Created: 2019-02-26T04:16:52.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-08-19T21:39:36.000Z (5 months ago)
• Last Synced: 2025-12-28T10:59:01.927Z (11 days ago)
• Topics: multiagent-reinforcement-learning, multiagent-systems, traffic-signal-control, traffic-simulation
• Language: C++
• Homepage: https://cityflow-project.github.io
• Size: 339 KB
• Stars: 958
• Watchers: 16
• Forks: 198
• Open Issues: 45
• Releases: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

README.rst

          CityFlow
============

.. image:: https://readthedocs.org/projects/cityflow/badge/?version=latest
    :target: https://cityflow.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. image:: https://dev.azure.com/CityFlow/CityFlow/_apis/build/status/cityflow-project.CityFlow?branchName=master
    :target: https://dev.azure.com/CityFlow/CityFlow/_build/latest?definitionId=2&branchName=master
    :alt: Build Status

CityFlow is a multi-agent reinforcement learning environment for large-scale city traffic scenario.

Checkout these features!

- A microscopic traffic simulator which simulates the behavior of each vehicle, providing highest level detail of traffic evolution.
- Supports flexible definitions for road network and traffic flow
- Provides friendly python interface for reinforcement learning
- **Fast!** Elaborately designed data structure and simulation algorithm with multithreading. Capable of simulating city-wide traffic. See the performance comparison with SUMO [#sumo]_.

.. figure:: https://user-images.githubusercontent.com/44251346/54403537-5ce16b00-470b-11e9-928d-76c8ba0ab463.png
    :align: center
    :alt: performance compared with SUMO

    Performance comparison between CityFlow with different number of threads (1, 2, 4, 8) and SUMO. From small 1x1 grid roadnet to city-level 30x30 roadnet. Even faster when you need to interact with the simulator through python API.

Screencast
----------

.. figure:: https://user-images.githubusercontent.com/44251346/62375390-c9e98600-b570-11e9-8808-e13dbe776f1e.gif
    :align: center
    :alt: demo

Featured Research and Projects Using CityFlow
---------------------------------------------
- `PressLight: Learning Max Pressure Control to Coordinate Traffic Signals in Arterial Network (KDD 2019) `_
- `CoLight: Learning Network-level Cooperation for Traffic Signal Control `_
- `Traffic Signal Control Benchmark `_
- `TSCC2050: A Traffic Signal Control Game by Tianrang Intelligence (in Chinese) `_ [#tianrang]_

Links
-----

- `WWW 2019 Demo Paper `_
- `Home Page `_
- `Documentation and Quick Start `_
- `Docker `_


.. [#sumo] `SUMO home page `_
.. [#tianrang] `Tianrang Intelligence home page `_

        

---

Owner metadata

• Name: cityflow-project
• Login: cityflow-project
• Email:
• Kind: organization
• Description:
• Website:
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/48002753?v=4
• Repositories: 5
• Last ynced at: 2023-03-05T14:16:11.646Z
• Profile URL: https://github.com/cityflow-project

---

GitHub Events

Total

• Issues event: 6
• Watch event: 134
• Issue comment event: 9
• Push event: 1
• Pull request event: 1
• Fork event: 16

Last Year

• Issues event: 4
• Watch event: 109
• Issue comment event: 8
• Push event: 1
• Pull request event: 1
• Fork event: 15

---

Committers metadata

Last synced: 8 days ago

Name	Email	Commits
Qidong Su	s****l@g****m	32
zhc134	me@z****m	25
Siyuan Feng	H****y@s****n	5
only-changer	o****r@s****n	5
이중건 Isaac Lee	4****c	2
zyr17	j****7@g****m	1
chacha	c****7@g****m	1
Weinan Zhang	z****9@g****m	1
Hua Wei	w****a@g****m	1

Committer domains:

• sjtu.edu.cn: 2
• zhanghuichu.com: 1

---

Issue and Pull Request metadata

Last synced: 16 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/cityflow-project/CityFlow

---

---

---

Dependencies

Score: 9.107975365298156