Getting Started

Your First Simulation

MotoQuant runs in the browser — no installation required to simulate. The desktop app and API are optional for advanced workflows. Start here.

Option A — Web Simulator (instant, no account)

1

Open the simulator

Navigate to /simulator. No account required.

2

Pick your bike

Use the category tabs (Indian Sport / Indian Naked / Royal Enfield / Dream Bikes) or the search box to find your bike. The widget defaults to the Suzuki Hayabusa Gen1 — one of the best-validated bikes in the catalog.

If your bike is not listed, use the "Suggest a bike" form on the Bikes page. We add community-requested bikes regularly.

3

Set your conditions

The three sliders control:

  • Rider weight — your weight in kg. Affects total system mass and CoG height.
  • Power boost — percentage modifier on peak power and torque. Use this to simulate mods without selecting individual parts.
  • Mass change — kg added or removed. Positive = added weight (pillion, luggage). Negative = weight reduction (stripped bodywork).
4

Set your venue (optional)

Click Race location and either select a named venue (Aamby Valley, MMRT, BIC, Santa Pod, etc.) or enter your GPS coordinates. The simulator loads seasonal weather data automatically — density altitude, temperature, humidity, surface grip.

If you skip this, the simulation runs at ISA sea-level conditions (15°C, 101.325 kPa, 0 m).

5

Run and read the results

Press Run Simulation. Results appear in under a second:

  • Quarter-Mile ET — elapsed time at 402.336 m, in seconds.
  • Trap Speed — velocity at the 402 m mark, in km/h.
  • Split Timeline — 60 ft, ⅛ mile, and ¼ mile ETs.
  • Peak Power — effective power after altitude correction.

Option B — Desktop App (beta)

The desktop app runs the same physics engine locally with no cloud dependency. It adds five pages: full Simulate, Bikes browser, Build (parts composer), Compare (A-vs-B), and History (local leaderboard).

Beta access

Desktop beta is currently available to tuning shops and racing teams. Email motoquant@gmail.com with your use case to apply.

1

Prerequisites

The desktop app requires macOS 13+, Windows 10/11 (x64), or Linux (Ubuntu 20+). The Python physics sidecar is bundled — no separate Python install needed.

2

Install

Download the installer from the release link provided in your beta invite email. Run the installer; it places the MotoQuant Pro app in your Applications / Program Files folder.

3

First launch

On first launch, the app spawns the physics sidecar on a random localhost port. You will see a loading screen for 2–8 seconds while the sidecar starts, then the Simulate page appears. The engine status chip in the top bar should show Engine online.

4

Development mode

If you are contributing to the frontend and want to run against a live API, set:

MOTOQUANT_DEV_BACKEND_URL=http://127.0.0.1:8000

in your environment before launching the app. The app will skip the sidecar spawn and hit your manually-started uvicorn instance instead.

Option C — REST API

The API is public and CORS-open. No authentication for basic simulation (rate-limited to 60 req/min per IP).

1

Quick sim

POST https://web-production-de6eb.up.railway.app/api/simulate/quick Content-Type: application/json { "bike_id": 1, "rider_mass_kg": 70, "power_boost_pct": 0, "mass_delta_kg": 0 }

Returns: et_quarter_s, trap_speed_kmh, et_60ft_s, et_eighth_s, peak_power_hp, bike_name.

2

Full sim with timeseries

POST /api/simulate { "bike_id": 1, "rider_mass_kg": 70, "power_boost_pct": 0, "use_adaptive_dt": false }

Returns everything from quick sim plus timeseries: arrays of velocity, RPM, gear, acceleration, power at every 10 ms step.

3

Interactive docs

Full OpenAPI interactive docs (try-it-now) are available at:

https://web-production-de6eb.up.railway.app/docs

Reading the Simulation Chart

The desktop app (and the full simulator page) shows a 4-panel chart:

Speed (km/h)
Velocity over time. The slope of this curve is your instantaneous acceleration. A steep slope in first gear, flattening out toward trap speed.
RPM
Engine RPM over time. You should see it rise to redline in each gear, drop at each upshift, then rise again. If RPM is flat for long periods, the clutch is slipping.
Acceleration (g)
Longitudinal g-force. Typically 0.3–0.6g at launch for street bikes, 0.5–0.9g for built drag bikes. The ET reference line marks where ¼ mile falls on the time axis.
Power (kW)
Wheel power delivered to the road. This is lower than engine power due to drivetrain losses, clutch slip during engagement, and tyre slip.