# Troubleshooting

Work from the top of the relevant section and run one diagnostic at a time.

Execution context: Check the execution computer for each diagnostic.

> Verification pending: existing website examples have not completed a pinned-source or physical-hardware walkthrough. Confirm software version, hardware revision, and actual stopping procedure. Do not assume emergency-stop or release-to-stop behavior. Explicit human approval and supervision are required before physical movement.

## Plugin

Reinstall the locked controller environment and verify the installed plugin version.

```shell
uv sync --locked --extra sourccey-desktop --extra training
```

```shell
uv run python -c "import importlib.metadata as m; print(m.version('lerobot-robot-sourccey'))"
```

## Network

Confirm the example IP was replaced, both computers share a network, and sourccey-host is still running.

```shell
ping 192.168.1.243
```

## Leader arms

Disconnect one leader arm and find the remaining port. Repeat for the other arm.

```shell
uv run lerobot-find-port
```

- Check the selected port.
- Check USB and motor power.
- Close other processes using the serial port.

## Cameras and hardware

With the host running, check cameras from the controller.

```shell
uv run python scripts/sourccey_check_eye_cameras.py --remote-ip 192.168.1.243
```

```shell
uv run python scripts/sourccey_check_arm_cameras.py --remote-ip 192.168.1.243
```

Stop sourccey-host before direct device checks on the robot computer.

## Datasets

Confirm the dataset ID is identical in record and train commands. Decode, consistency, and feature-cleanup errors should be resolved before training.

Website: https://vulcanrobotics.ai/docs/lerobot/troubleshooting

Upstream reference (unpinned): https://github.com/vulcan-forge/lerobot-vulcan/blob/main/docs/sourccey/troubleshooting.md