v0.1.31 Python 3.12+ MIT License Routes API v2

The Personal Routing & Fleet FinOps Commander

Calculate optimal routes for your custom vehicle fleet and current intent. Features eco-aware routing, live fuel price discovery, waypoint weather corridors, ASCII elevation profiles, and DoorDash IRS mileage shelter ledgers.

uv tool install git+https://github.com/charles-forsyth/roam.git

View Repository Explore Terminal Output

Key Capabilities

Engineered for drivers, commuters, and delivery operators managing multi-vehicle fleets.

🚘

Fleet Garage FinOps

Define your vehicle fleet with custom fuel types, highway/city MPG, and compare trip fuel costs across every vehicle instantly.

🌍

Eco-Aware Routing

Supports drive, bicycle, two-wheeler, transit, and walking modes with engine emission optimizations (gasoline, EV, hybrid, diesel).

⛅

Corridor Weather & Elevation

Checks hourly or multi-day weather at waypoints timed precisely to your arrival, with ASCII elevation gain/loss profiles.

💸

IRS Tax Shelter Ledger

Calculates DoorDash and gig delivery shift profitability against the IRS standard mileage deduction ($0.67/mi) and actual fuel costs.

Terminal Showcase

Real, unmodified terminal outputs captured directly from the CLI engine.

roam --help

roam doordash --start "Downtown" --end "Uptown" --miles 25.0 --earnings 45.00

Usage Examples

Command recipes for everyday navigation and fleet operations.

Standard Route Calculation

Calculate optimal driving directions to a destination:

roam "Los Angeles"

Fleet Vehicle Comparison

Compare fuel expenses across all garage vehicles:

roam "Las Vegas" --compare --econ

Route Corridor Weather

Check arrival-timed weather and elevation profile:

roam "Big Bear" -W -E

Gig Delivery FinOps

Track delivery shift tax shelter and net profit:

roam doordash --start "Central" --end "North" --miles 35.2 --earnings 62.50

Citation

If you use Roam in research or fleet logistics operations, please cite this repository:

Forsyth, C. E. III (2026). Roam: The Personal Routing Commander (Version 0.1.31) [Computer software]. University of California, Riverside. https://doi.org/10.5281/zenodo.23755671

@software{forsyth2026roam,
  author       = {Forsyth, Charles E. III},
  title        = {Roam: The Personal Routing Commander},
  version      = {0.1.31},
  year         = {2026},
  publisher    = {Zenodo},
  affiliation  = {University of California, Riverside},
  doi          = {10.5281/zenodo.23755671},
  url          = {https://github.com/charles-forsyth/roam}
}