Report Abuse

Basic Information

This repository contains the official code and resources for the LLMLight project, which studies using Large Language Models as decision-making agents for Traffic Signal Control (TSC). It implements the LLMLight framework and the LightGPT backbone model described in the accompanying paper and provides scripts, data, trained models, and experiment configurations to reproduce and extend the research. The code integrates traffic simulation, LLM inference and training, and evaluation against transportation and reinforcement learning baselines across multiple real-world and synthetic road networks. It is organized to support running LLMLight with cloud-hosted chat models, open-source LLMs, or the LightGPT fine-tuned models and includes dependencies and environment notes required to run experiments.

Links

App Details

Features
The repository provides end-to-end research code for LLM-driven traffic signal control. Key features include: implementations to run LLMLight with hosted GPT-3.5/GPT-4 or open-source models via Transformers or VLLM, a LightGPT training pipeline with imitation fine-tuning and critic-guided policy refinement including scripts to collect policy refinement data and merge LoRA adapters, a set of baseline methods (heuristic, DNN-RL, advanced DNN-RL) for comparison, prepared datasets and traffic files for multiple city networks, simulation integration using CityFlow, organized directories for models, prompts, logs, frontend visual replays and error records, and example run scripts for common experiments.
Use Cases
This project helps researchers and practitioners explore LLMs as interpretable and generalizable controllers for urban traffic signal management. It provides reproducible experiments and tooling to evaluate LLM-based policies against established heuristic and RL baselines, enabling direct comparison on multiple datasets and network layouts. The training utilities allow fine-tuning and policy refinement of a specialized LightGPT model to lower-cost deployment scenarios. Provided run scripts, dataset files, simulation integration and visualization support accelerate prototyping, benchmarking and ablation studies. The codebase and organized logs/prompts make it easier to inspect decision traces and dialog logs for analysis and to adapt the approach to new traffic scenarios or research questions.

Please fill the required fields*