https://github.com/apneduniya/vity-device
An AI assistant for cross-device control, automating actions seamlessly between devices.
https://github.com/apneduniya/vity-device
bot capx capxai capxai-hackquest claude computer-control gemeni hackquest js openai python telegram-bot websocket
Last synced: about 2 months ago
JSON representation
An AI assistant for cross-device control, automating actions seamlessly between devices.
- Host: GitHub
- URL: https://github.com/apneduniya/vity-device
- Owner: apneduniya
- Created: 2024-11-24T16:22:06.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-12-01T11:24:43.000Z (6 months ago)
- Last Synced: 2025-02-02T09:33:10.803Z (4 months ago)
- Topics: bot, capx, capxai, capxai-hackquest, claude, computer-control, gemeni, hackquest, js, openai, python, telegram-bot, websocket
- Language: Python
- Homepage: https://t.me/vity_device_bot
- Size: 10.7 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Vity Device 🤖
A telegram bot which will help you to connect your devices and automate its actions seamlessly between devices 🔥
## 📋 Table of Contents
- [Demo](#-demo)
- [Features](#-features)
- [Prerequisites](#-prerequisites)
- [Steps to Run](#-steps-to-run)
- [Project structure](#%EF%B8%8F-project-structure)
- [Contributing](#-contributing)
- [Acknowledgments](#-acknowledgments)
- [License](#-license)
## 🎥 DEMO
[](https://www.youtube.com/watch?v=PL2cr0tVX1U)
## 📙 Features
This telegram bot agent can:
- Interact with nearly all apps and browsers.
- Integrated with **GPT-4o, Gemini Pro Vision, Claude 3 and LLaVa.**
- **Future plan:** Send response back to the commander.
- **Future plan:** Connect multiple mobile phones and tablets remotely at once.
## 🫳 Prerequisites
You should have
- [Python 3.11 or higher](https://www.python.org/downloads/)
- API key of any model from **GPT-4o, Gemini Pro Vision, Claude 3 and LLaVa.**
## 👣 Steps to Run
**Navigate to the Project Directory:**
Change to the directory where the project files are located. For example:
```shell
cd path/to/project/directory
```
1. Change the directory.
```bash
cd host
```
2. Create a virtual environment.
```bash
python3 virtualenv venv
```
3. Activate the virtual environment.
```bash
source ./venv/bin/activate
```
4. Install dependencies from `requirements.txt`
```bash
pip install -r requirements.txt
```
5. Configure environment variables
1. Copy `.env.example` to `.env`.
2. Fill in the `.env` file with the necessary environment variables.
6. Start the server
```bash
python3 main.py
```
## 🏛️ Project structure
```bash
├── .env.local.example
├── .eslintrc.json
├── .gitignore
├── README.md
├── bun.lockb
├── components.json
├── host
│ ├── .env.example
│ ├── .gitignore
│ ├── agent.py
│ ├── listner.py
│ ├── main.py
│ ├── operate
│ │ ├── __init__.py
│ │ ├── config.py
│ │ ├── exceptions.py
│ │ ├── main.py
│ │ ├── models
│ │ │ ├── __init__.py
│ │ │ ├── apis.py
│ │ │ ├── prompts.py
│ │ │ └── weights
│ │ │ ├── __init__.py
│ │ │ └── best.pt
│ │ ├── operate.py
│ │ └── utils
│ │ ├── __init__.py
│ │ ├── label.py
│ │ ├── misc.py
│ │ ├── ocr.py
│ │ ├── operating_system.py
│ │ ├── screenshot.py
│ │ └── style.py
│ ├── requirements.txt
│ ├── screenshots
│ ├── test.py
│ └── temp.py
├── next-env.d.ts
├── next.config.ts
├── package.json
├── postcss.config.mjs
├── public
│ ├── file.svg
│ ├── globe.svg
│ ├── next.svg
│ ├── vercel.svg
│ └── window.svg
├── src
│ ├── app
│ │ ├── api
│ │ │ ├── prompt
│ │ │ │ └── route.ts
│ │ │ └── verify
│ │ │ └── route.ts
│ │ ├── favicon.ico
│ │ ├── fonts
│ │ │ ├── GeistMonoVF.woff
│ │ │ └── GeistVF.woff
│ │ ├── globals.css
│ │ ├── layout.tsx
│ │ └── page.tsx
│ ├── components
│ │ ├── blocks
│ │ │ ├── expandable-card-demo-grid.jsx
│ │ │ └── expandable-card-demo-standard.jsx
│ │ ├── common
│ │ │ ├── DotBackground.tsx
│ │ │ ├── InputWithButton.tsx
│ │ │ ├── Loader.tsx
│ │ │ └── PromptSuggestionButtton.tsx
│ │ ├── theme-provider.tsx
│ │ └── ui
│ │ ├── alert.tsx
│ │ ├── animated-modal.tsx
│ │ ├── badge.tsx
│ │ ├── button.tsx
│ │ ├── dialog.tsx
│ │ ├── flip-words.tsx
│ │ ├── input.tsx
│ │ ├── select.tsx
│ │ ├── toast.tsx
│ │ └── toaster.tsx
│ ├── context
│ │ ├── PrivyProvider.tsx
│ │ └── UserAuthContext.tsx
│ ├── hooks
│ │ ├── use-outside-click.js
│ │ ├── use-toast.js
│ │ └── use-toast.ts
│ ├── lib
│ │ ├── ably.ts
│ │ └── utils.ts
│ ├── providers
│ │ └── index.tsx
│ └── utils
│ ├── api.ts
│ └── setTokenCookies.ts
├── tailwind.config.ts
└── tsconfig.json
```
## 🤗 Contributing
1. Fork the repository.
2. Create a new branch: `git checkout -b feature-name`.
3. Make your changes.
4. Push your branch: `git push origin feature-name`.
5. Create a pull request.
## ✍ Acknowledgments
This project couldn't be possible if [CapxAI](https://www.capx.ai/) didn't be there!
Even I had many issues while making this project and this was my first time to make a telegram bot but there team helped me a lot to over come the issues, gave me suggestions and I am really thankful to it ❤️🩹!
## 🧾 License
This project is licensed under the [MIT License](LICENSE).