About Capabilities Metrics GitHub ↗
Digital Twin Simulation Engine

Cities are living systems. We simulate them.

UrbanFlow models the chaos of real-world traffic — every pedestrian decision, every near-miss, every millisecond — so you don't have to guess.

What is UrbanFlow

Not another dashboard.
A digital nervous system
for your city.

Traditional traffic models are static. They assume perfect conditions and rational actors. But real cities are messy — jaywalkers dart across six lanes, delivery trucks double-park, a single distracted driver cascades into thirty minutes of gridlock.

UrbanFlow is an agent-based simulation engine built in Python that models every individual — vehicle, pedestrian, cyclist — as an autonomous agent with its own decision-making logic. The result? A digital twin that breathes like a real city.

Core Capabilities
Pedestrian crossing simulation
01

Pedestrian Dynamics

Every pedestrian is an autonomous agent with behavioral states — waiting, crossing, jaywalking, panicking. They react to traffic signals, nearby vehicles, and other pedestrians in real-time. No scripted paths. Pure emergent behavior.

  • Agent-based behavioral state machines
  • Jaywalking probability modeling
  • Crowd density-aware pathfinding
Traffic flow visualization
02

Collision Avoidance

The physics engine doesn't just detect obstacles — it models emergency braking dynamics, tire friction coefficients, and reaction time distributions. Skid marks render dynamically based on actual deceleration forces.

  • Multi-body physics simulation
  • Emergency braking with reaction delay
  • Procedural skid mark generation
City-scale telemetry overview
03

Real-time Telemetry

Every agent continuously streams position, velocity, acceleration, and interaction events to an integrated SQLite database. Analyze traffic patterns, near-miss events, and congestion bottlenecks with millisecond granularity.

  • High-frequency data streaming per agent
  • SQLite integration for deep analytics
  • Exportable telemetry snapshots
By the Numbers
0
Concurrent Agents
0
Render Performance
0
Physics Latency
0
Open Source
Built With

Clean architecture.
Zero bloat.

UrbanFlow is built on Python with Pygame for rendering, SQLite for telemetry storage, and pure math for physics. No heavyweight frameworks. No cloud dependencies. Just code that runs.

🐍
Python
Core Engine
🎮
Pygame
Rendering
🗄️
SQLite
Telemetry
Pure Math
Physics