https://github.com/nata-vito/see_how_pkg
Project developed with the aim of integrating technologies such as computer vision into ROS, with a view to ease of adaptation and accessibility.
https://github.com/nata-vito/see_how_pkg
mediapipe opencv python ros-melodic
Last synced: 2 months ago
JSON representation
Project developed with the aim of integrating technologies such as computer vision into ROS, with a view to ease of adaptation and accessibility.
- Host: GitHub
- URL: https://github.com/nata-vito/see_how_pkg
- Owner: nata-vito
- Created: 2023-01-10T17:13:28.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-03-31T15:19:35.000Z (about 3 years ago)
- Last Synced: 2025-08-17T07:14:07.349Z (10 months ago)
- Topics: mediapipe, opencv, python, ros-melodic
- Language: Python
- Homepage:
- Size: 224 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SEE HOW PACKAGE
> Project developed with the objective of integrating technologies such as computer vision to the ROS, aiming for ease of adaptation.
### Adjustments and improvements
The project is still under development and the next updates will focus on the following tasks:
- [ ] Graphical View of the Results
- [x] Docker Image
- [x] FastApi
- [ ] Database Integration
---
## 💻 Prerequisites
Before you begin, check that you have met the following requirements:
* `Ubuntu 18.04`
* `ROS Melodic`
* `Python 3.10`
* `rospy`
* `ros_numpy`
* `cv2`
* `mediapipe`
* `numpy`
* `cv_bridge`
---
## 🚀 Installing SEE HOW PACKAGE
To install the SEE HOW PACKAGE, follow these steps:
Linux:
```
mkdir -p ws/src
cd ws/src
git clone https://github.com/nata-vito/see_how_pkg.git
cd ..
catkin_make
source devel/setup.bash
```
---
Docker:
- Requirements for the proper functioning of the Image
- First of all, install the NVIDIA Container Toolkit and its drivers following the official Nvidia documentation. NVIDIA Documentation: https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker
---
### Running the image
After that, run the commands below.
- Command to download the image:
```docker pull natavitorino/cuda-ros:```
- Command to release screen access:
```xhost +local:docker```
- Command to run the contianer with privileges:
```docker run -it --rm --name --privileged --net=host --env=NVIDIA_VISIBLE_DEVICES=all --env=NVIDIA_DRIVER_CAPABILITIES=all --env=DISPLAY --env=QT_X11_NO_MITSHM=1 -v /tmp/.X11-unix:/tmp/.X11-unix --gpus all natavitorino/cuda-ros: bash```
---
- Tags:
```1.0``` - Version without Yolo support
```1.1``` - Version with Yolo support
```1.2``` - Version with Virtual Assistant BRAIN support
---
## ☕ Using SEE HOW PACKAGE
To use SEE HOW PACKAGE, follow these steps:
```
roslaunch see_how_pkg see_how.launch
```
If you can't run it, make sure you have `source devel/setup.bash` inside the ws folder. If not, run the command again in all terminal windows.
Modify the shebang of the components to be copied correctly, the current shebangs are set to run on the official docker image of the project.
---
## 📫 Contributing to SEE HOW PACKAGE
To contribute to SEE HOW PACKAGE, follow these steps:
1. Fork this repository.
2. Create a branch: `git checkout -b `.
3. Make your changes and confirm them: `git commit -m ''`
4. Send to original branch: `git push origin / `
5. Create the pull request.
Alternatively, see the GitHub documentation on [how to create a pull request].(https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request).
---
## 🤝 Collaborators
We thank the following people who contributed to this project:
---
## 😄 Be one of the contributors
Want to be part of this project? Click [HERE](CONTRIBUTING.md) and read how to contribute.
---
## 📝 License
This project is under license. See the file [LICENSE](LICENSE.md) for more details.
[⬆ Back to top](#SEE-HOW-PACKAGE)
