ros2em 0.1.2

ROS2 Environment Manager using Virtualbox and Vagrant

ros2em - ROS2 Environment Manager

ros2em is a CLI tool to create and manage isolated ROS2 environments using VirtualBox and Vagrant.

Whether you're a robotics developer, student, or researcher, ros2em makes it easy to:

• 🧠 Launch ROS2 in clean, isolated virtual machines
• 🖥 Access GUIs like Rviz or Gazebo via browser
• ✅ Support both amd64 and arm64 architectures
• 🧰 Handle setup: VirtualBox, Vagrant, and box file download

---

🚀 Features

• ⚡ One-line setup for fully functional ROS 2 VMs
• 📦 Architecture-specific box handling (amd64, arm64)
• 🖥 GUI access using browser
• 🔐 No system pollution – nothing touches your host machine
• 💡 Powered by Typer (CLI) and Rich (colored output)

---

📦 Installation

Recommended (via pipx)

pipx install ros2em

Or using pip

pip install ros2em

---

🛠 Commands

🔧 Setup dependencies

ros2em init

Installs VirtualBox and Vagrant (if not found).

⬇️ Download the correct ROS2 box

ros2em download-box

Auto-detects your architecture and downloads the appropriate .box file.

🐢 Create an environment

ros2em create myenv

Creates ~/.ros2em/myenv and spins up a VM.

📋 Manage environments

ros2em list        # List all environments
ros2em start myenv # Start a VM
ros2em stop myenv  # Stop a VM
ros2em delete myenv # Delete an environment

---

📁 Environment Structure

~/.ros2em/
├── boxes/
│   └── arm64/ or amd64/
│       └── ros2-humble.box
├── myenv/
│   └── Vagrantfile

---

🧩 Contributing

We welcome contributions, ideas, and feedback.

• Open issues for bugs and enhancements
• Fork and submit a pull request
• Share your use case via Discussions

---

📄 License

MIT License — © 2025 Kodo Robotics