# Twinworks

> Model a production line, simulate it and find the bottleneck — free, in your browser. Twinworks is a factory digital twin that runs entirely in your browser. Draw a production line on a floor plan with sources, buffers, machines, assembly stations, conveyors, quality checks and operators, then watch a seeded discrete-event simulation animate it in 2D or 3D. Live KPIs show throughput, lead time, WIP with a Little’s-law check, OEE per machine, state Gantt charts and the bottleneck, and the scenario manager, parameter sweeps and cost model turn it into a what-if laboratory.

Twinworks (Factory digital twin & production simulation) is a premium app of usefulweb.app (https://usefulweb.app/): a full program that runs in the browser. Its engine is deterministic and the same functions are exposed as tools, so an agent can compute exactly what the app shows.

## Use it
- Landing page: https://twinworks.usefulweb.app/
- Workspace (browser app): https://twinworks.usefulweb.app/app - open a project with https://twinworks.usefulweb.app/app#project=<base64url-encoded project JSON> or a template with https://twinworks.usefulweb.app/app#template=<id>
- Project file format (JSON Schema): https://twinworks.usefulweb.app/project.schema.json
- Tutorials: https://twinworks.usefulweb.app/tutorials
- JSON API: POST https://twinworks.usefulweb.app/api/v1/tools/<toolId>/calculate (catalog: https://twinworks.usefulweb.app/api/v1/tools)
- OpenAPI: https://twinworks.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://twinworks.usefulweb.app/mcp

## Engine tools
- [Twinworks Factory Simulation](https://twinworkssimulate.usefulweb.app/): Simulate a production line: throughput, lead time, WIP, OEE and the bottleneck, with CIs. API: POST https://twinworks.usefulweb.app/api/v1/tools/twinworks-simulate/calculate · MCP tool `twinworks_simulate`
- [Twinworks Bottleneck Analysis](https://twinworksbottleneckanalysis.usefulweb.app/): Find the constraint of a production line and test fixes: ranked bottlenecks with what-if gains. API: POST https://twinworks.usefulweb.app/api/v1/tools/twinworks-bottleneck-analysis/calculate · MCP tool `twinworks_bottleneck_analysis`
- [Twinworks Line Balancing](https://twinworkslinebalance.usefulweb.app/): Assign assembly tasks to stations for a takt time: efficiency, balance delay and smoothness index. API: POST https://twinworks.usefulweb.app/api/v1/tools/twinworks-line-balance/calculate · MCP tool `twinworks_line_balance`
- [Twinworks Buffer & Parameter Sweep](https://twinworksbuffersweep.usefulweb.app/): Sweep a buffer size (or any parameter) and get the throughput curve with confidence intervals. API: POST https://twinworks.usefulweb.app/api/v1/tools/twinworks-buffer-sweep/calculate · MCP tool `twinworks_buffer_sweep`
- [Twinworks Buffer Allocation Optimiser](https://apps.usefulweb.app/tools/twinworks-buffer-allocation/): Distribute a fixed number of buffer places over a line for maximum throughput. API: POST https://twinworks.usefulweb.app/api/v1/tools/twinworks-buffer-allocation/calculate · MCP tool `twinworks_buffer_allocation`
- [Twinworks Queueing Check](https://twinworksqueueformulas.usefulweb.app/): M/M/1, M/M/c, M/D/1, M/G/1 and Kingman waiting times — optionally verified by simulation. API: POST https://twinworks.usefulweb.app/api/v1/tools/twinworks-queue-formulas/calculate · MCP tool `twinworks_queue_formulas`

## Formats
- Import: Twinworks project (.twinworks.json), Twinworks model JSON, Station table (CSV/TSV from a spreadsheet, MES or routing sheet), Project link (#project=…)
- Export: Twinworks project (.twinworks.json), CSV event log, CSV time series, CSV station KPIs, PNG and SVG of the layout, PNG and SVG of charts, Printable KPI report (PDF via print)

## Limits
- Discrete parts only: no continuous flow (liquids, bulk material) or fluid tanks.
- Transport between objects is instantaneous unless you model it as a conveyor; there are no AGVs, forklifts or path finding.
- Operators are pooled resources without walking times, skills matrices or individual schedules.
- Conveyors use a slot model (length ÷ pitch) rather than exact physics; merges and curves are not modelled geometrically.
- The 3D view is a schematic visualisation, not CAD; no import of 3D models or DWG floor plans.
- Optimisation covers buffer allocation (greedy, one place at a time); other parameters are explored with one-parameter sweeps rather than a general optimisation solver.
- On phones the plan opens view-only (pan, pinch-zoom, simulate); editing can be switched on but is easiest on a tablet or computer.
- API calls are limited to roughly 40 million events per request; long studies run best in the app.