Skip to content

Add setup.sh and streamline GUIDE.md setup#3

Merged
kavya-chennoju merged 3 commits intofeat/device-connect-integration-draftfrom
guide-setup-instructions-v2
Mar 17, 2026
Merged

Add setup.sh and streamline GUIDE.md setup#3
kavya-chennoju merged 3 commits intofeat/device-connect-integration-draftfrom
guide-setup-instructions-v2

Conversation

@kavya-chennoju
Copy link
Collaborator

@kavya-chennoju kavya-chennoju commented Mar 17, 2026

Summary

  • Add setup.sh — one-command environment setup (installs uv, Python 3.12, creates venv, installs all deps)
  • Simplify GUIDE.md from manual Python/venv/pip steps to two steps: install and start a robot
  • Add screen session management for running the robot in the background

Test plan

  • Run bash strands_robots/device_connect/setup.sh from repo root — verify uv, Python 3.12, venv, and packages install
  • Start a robot in a screen session and verify discovery works from another terminal
  • Verify screen -ls / screen -r robot workflow

- Add setup.sh: handles uv install, Python 3.12, venv creation, and
  package installation in one command
- Simplify GUIDE.md setup to two steps: install and start a robot
- Replace manual Python/venv/pip steps with setup.sh reference
- Add screen session management for running the robot in the background
# Ubuntu: sudo apt install python3.12 python3.12-venv

python3.12 -m venv .venv # Python 3.12 recommended (MuJoCo has no 3.14 wheels)
bash strands_robots/device_connect/setup.sh
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably simpler to just vend this chmod 755 and simply: ./path/to/setup.sh

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated, git already tracks it as executable.

```

**Start a robot (keep running in a separate terminal):**
This installs `uv`, Python 3.12, creates a venv, and installs all dependencies.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can move this up to being a note in step 1 (as opposed to reading this after running setup script).

Copy link
Collaborator Author

@kavya-chennoju kavya-chennoju Mar 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done moved to the top of the section.

"
# once online, Ctrl+a then d to detach
# screen -ls to list sessions
# screen -r robot to reattach
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice

Copy link
Collaborator

@rjm-git rjm-git left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just some minor comments. Overall lgtm.

@kavya-chennoju kavya-chennoju merged commit 2d40356 into feat/device-connect-integration-draft Mar 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants