Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abhiprojectz/singulargpt
SingularGPT - Automate device by ChatGPT , Make your device more like a human. For sponsoring visit the link. ($15 - One time)
https://github.com/abhiprojectz/singulargpt
ai-visionary automation chatgpt gpt4 opencv
Last synced: 3 days ago
JSON representation
SingularGPT - Automate device by ChatGPT , Make your device more like a human. For sponsoring visit the link. ($15 - One time)
- Host: GitHub
- URL: https://github.com/abhiprojectz/singulargpt
- Owner: abhiprojectz
- License: apache-2.0
- Created: 2023-04-07T05:39:32.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-02-26T15:48:05.000Z (9 months ago)
- Last Synced: 2024-02-26T16:48:24.269Z (9 months ago)
- Topics: ai-visionary, automation, chatgpt, gpt4, opencv
- Language: Python
- Homepage: https://itsanicode.lemonsqueezy.com/checkout/buy/c1a279a2-097c-449f-b6fc-e086a0b29c48
- Size: 720 KB
- Stars: 182
- Watchers: 12
- Forks: 11
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**SingularGPT** is a open source project that automates your device using ChatGPT & GPT-4.
With 🚀 **SingularGPT** you can easily instruct your device with simple text based queries.
[](https://colab.research.google.com/github/abhiprojectz/SingularGPT/blob/master/SGPT_Quickstart.ipynb)
> For example:
Let's say you need to click on button that have a text as 'File' just say it:
**Query:** Hey, please click on the item with text File.
It will perform the action by processing your query, turning them to its undernstandable instructions and execute them.
---
# :star2: Demo
https://user-images.githubusercontent.com/64596494/230719544-a9bee6f2-4158-4784-b0ed-260bea7be067.mp4
---
# :star2: How to Use ?
You may just run it in google colab with a GPU.
[](https://colab.research.google.com/github/abhiprojectz/SingularGPT/blob/master/SGPT_Quickstart.ipynb)
**Follow these steps carefully**
- 1. Install all the requirements
```
pip install -r requirements.txt
```
Make sure that you run this command in the same directory where the `requirements.txt` file is located.
- 2. If you are in linux then install below libs
```sh
!sudo apt-get install xvfb xorg xserver-xorg scrot imagemagick x11-utils xdotool
```
- 3. Create a .env file and place your OPENAI_API and change your platform name in `config/CONFIG.py`
if you are on linux set as: `_PLATFORM` as linux [By default is `windows`]
- 4. Run this file `main.py` by passing your query.
```py
python main.py
```
- 5. Use `SingularGPT` bot if you are stuck or raise a issue
- 6. Make sure your instructions are in `script.py` file.
## :star2: Quickstart
Create a `.env` file with `OPENAI_API` and place your openai_api api there or pass as environment variable.
Put automation scripts in `script.py` and run it.
Write your prompt query in `Prompts/prompts.txt` file or,
pass as a string in the `main.py` file.
```py
# Run the main script.
python main.py
```
---
**To visualize this see this bot on Poe**
---
# :star2: How it locates element ?
The old way using X_PATH or CSS/JS Selectors or by just co-ordinates.
```py
element_xpath = driver.find_element(By.XPATH, "//a[@href='/login']")
element_xpath.click()
# or
element_css = driver.find_element(By.CSS_SELECTOR, "button.btn-primary")
element_css.click()
```
> No, it uses the new GUI element detection techniques.
Nopes !
```py
zex.text('Menu').click()
zex.text('Edit').FindLeftOf().click() # Used to locate the element that is just left side of the target element.
```
---
**Locate and perform actions to the element that is left or right or even the most nearest element to it.**
ZexUI is a standalone library that uses image processing techniques for GUI automation.
---
# :star2: Automations lib apis
Here are some methods and thier usage.
Sure! Here are the descriptions for each method:
- `text()`: This method is used to locate a text element on the webpage based on the text content provided in the query.
- `textRegex()`: This method is used to locate a text element on the webpage based on a regular expression provided in the query.
- `textContains()`: This method is used to locate a text element on the webpage that contains a specific word provided in the query.
- `image()`: This method is used to locate an image element on the webpage based on the image path provided in the query.
- `findLeftOf()`: This method is used to locate an element that is to the left of the text/image provided in the query.
- `findRightOf()`: This method is used to locate an element that is to the right of the text/image provided in the query.
- `findTopOf()`: This method is used to locate an element that is above the text/image provided in the query.
- `findBottomOf()`: This method is used to locate an element that is below the text/image provided in the query.
- `findNearestTo()`: This method is used to locate the element that is nearest to the text/image provided in the query.
- `click()`: This method is used to click on the element that is located using the text/image or any other method.
- `mouseMove()`: This method is used to move the mouse to the element that is located using the text/image or any other method.
- `scroll_up()`: This method is used to scroll up the webpage.
- `scroll_down()`: This method is used to scroll down the webpage.
- `scroll_left()`: This method is used to scroll left on the webpage.
- `scroll_right()`: This method is used to scroll right on the webpage.
... More are on the docs.
**This is what this project aims and tries to achieve the same.**
:star2: So, here's how the things works under the hood:
+ Converts Natural language query to automation scripts that further can be used to achieve the task
+ SingularGPT Process your screen, gets the required data what's being asked.
+ Generates commands to achieve the task.
---
# :star2: What SingularGPT can do ?
+ Recognize what's on your screen
+ Even what's on your headless server using x11
+ Can internally process them.
+ Build automations scripts by its own
+ Automates your device
---
# :star2: Breakdown of the project
This projects is made possible with the help of various fields in computer science such as AI based vision, Custom libs, device automation and internal logic processing using the latest ChatGPT & GPT-4.
In short:
AI computer vision + Automation (ZexUI) + GPT
---
# :star2: Features
+ No crawling mechanism
+ Elements detection
+ Text detection
+ Components detection based on estimates
+ Automate your device using NLP instructions
+ Adds-on in a very lightweight presets
+ Works even headless on a x11 server
# :star2: Help
Considering leaving a star.
# :star2: Docs
Help in writing the docs for the project.
---