# `mix bb_so101.install`
[🔗](https://github.com/beam-bots/bb_so101/blob/main/lib/mix/tasks/bb_so101.install.ex#L6)

Installs an SO-101 robot definition into a project

Composes `bb.install` to scaffold a robot module + supervision, fills in the
full SO-101 6-DOF topology, and wires the Feetech servo bus via
`bb_servo_feetech.install`.

The generated `application.ex` includes a `robot_opts/0` helper that boots
the robot in `:kinematic` simulation mode when the `SIMULATE` environment
variable is set, and otherwise points it at the configured serial device.

To add a live dashboard, run `mix igniter.install bb_liveview` after this
task.

## Example

```bash
mix igniter.install bb_so101
mix igniter.install bb_so101 --robot MyApp.Arm --device /dev/ttyACM0

# Run the generated app in simulation mode (no hardware needed)
SIMULATE=1 iex -S mix
```

## Options

  * `--robot` - Robot module name (defaults to `{AppPrefix}.Robot`)
  * `--device` - Serial device path (default `/dev/ttyUSB0`)

---

*Consult [api-reference.md](api-reference.md) for complete listing*