| Name | py-browser-automation JSON |
| Version |
0.1.7
JSON |
| download |
| home_page | None |
| Summary | Automate online browsing using python and AI |
| upload_time | 2025-10-26 21:01:09 |
| maintainer | None |
| docs_url | None |
| author | pUrGe12 |
| requires_python | <4.0,>=3.10 |
| license | MIT |
| keywords |
browser-automations
ai
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# PyBA - Python Browser Automations
This is a browser automation software written in python. It can visit any website, automate testing, repetitive tasks, form filling and more. This library is specifically built for more exploratory analysis than EXACT outputs.
## Idea
This library will allow you to run an inhouse playwright instance and automate any task. These tasks can be related to web-scraping, OSINT (OpenSource INTelligence) etc.
This is built on top of playwright and it requires either VertexAI or OpenAI API keys to do the "thinking" part of the process. The library also contains support to automatically login to your social media sites (you'll have to provide a username and password! Check the the [usage](#usage) section for more on that) so you can use it for SOCmint or simple automated social media interactions as well.
We optionally allow you to enable tracing, the logs of which you can see on playwright's `traceviewer`.
## Why?
The need for such a software came when I was building a fully automated intelligence framework. The goal is to replicate everything a human can do on the internet, and automate that process. This tool will employ all sorts of anti-bot detection and anti-fingerprinting techniques (I am still learning about them...) and will make sure that nothing halts the automation.
## Installation
The library can be installed via `pip`:
```sh
pip install py-browser-automation
```
or you can install it from the source:
```sh
git clone https://github.com/FauvidoTechnologies/PyBrowserAutomation/
cd PyBrowserAutomation
pip install .
```
## Usage
- Import the main engine using:
```python3
from pyba import Engine
```
- Set the right configurations depending on which model you want to use:
> For VertexAI
```python3
engine = Engine(vertexai_project_id="", vertexai_server_location="", handle_dependencies=False)
```
> For OpenAI
```python3
engine = Engine(openai_api_key="", handle_dependencies=False)
```
- Set `handle_dependencies` to `True` if you're running this for the first time and install the playwright browsers and other dependencies by following the instructions.
- Run the `sync` endpoint using `engine.sync_run()`
```python3
engine.sync_run(prompt="open instagram", automated_login_sites=["instagram"])
```
> You can set the `automated_login_sites` argument as whichever website you want to automatially login to.
For more use cases, check out the [examples](./examples) direcrtory.
This is useful in case of OSINT when you inevitably come across a profile that is hidden behind the login wall. Setting that field will trigger the login scripts to run after it verifies the site.
If you don't want to automatically login, don't set this value. The default behavior is to not do any such thing.
- We also have an async endpoint if you need. That can be called using just `.run()`
Raw data
{
"_id": null,
"home_page": null,
"name": "py-browser-automation",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "browser-automations, AI",
"author": "pUrGe12",
"author_email": "achintya.jai@owasp.org",
"download_url": "https://files.pythonhosted.org/packages/88/6f/e278428b224b24b58234a860e61ccfffb4e93bb040bf8544376ed49910dd/py_browser_automation-0.1.7.tar.gz",
"platform": null,
"description": "# PyBA - Python Browser Automations\n\nThis is a browser automation software written in python. It can visit any website, automate testing, repetitive tasks, form filling and more. This library is specifically built for more exploratory analysis than EXACT outputs.\n\n## Idea\n\nThis library will allow you to run an inhouse playwright instance and automate any task. These tasks can be related to web-scraping, OSINT (OpenSource INTelligence) etc.\n\nThis is built on top of playwright and it requires either VertexAI or OpenAI API keys to do the \"thinking\" part of the process. The library also contains support to automatically login to your social media sites (you'll have to provide a username and password! Check the the [usage](#usage) section for more on that) so you can use it for SOCmint or simple automated social media interactions as well.\n\nWe optionally allow you to enable tracing, the logs of which you can see on playwright's `traceviewer`.\n\n## Why?\n\nThe need for such a software came when I was building a fully automated intelligence framework. The goal is to replicate everything a human can do on the internet, and automate that process. This tool will employ all sorts of anti-bot detection and anti-fingerprinting techniques (I am still learning about them...) and will make sure that nothing halts the automation.\n\n## Installation\n\nThe library can be installed via `pip`:\n\n```sh\npip install py-browser-automation\n```\n\nor you can install it from the source:\n\n```sh\ngit clone https://github.com/FauvidoTechnologies/PyBrowserAutomation/\ncd PyBrowserAutomation\npip install .\n```\n\n## Usage\n\n- Import the main engine using:\n\n```python3\nfrom pyba import Engine\n```\n\n- Set the right configurations depending on which model you want to use:\n\n> For VertexAI\n```python3\nengine = Engine(vertexai_project_id=\"\", vertexai_server_location=\"\", handle_dependencies=False)\n```\n\n> For OpenAI\n```python3\nengine = Engine(openai_api_key=\"\", handle_dependencies=False)\n```\n\n- Set `handle_dependencies` to `True` if you're running this for the first time and install the playwright browsers and other dependencies by following the instructions.\n\n- Run the `sync` endpoint using `engine.sync_run()`\n\n```python3\nengine.sync_run(prompt=\"open instagram\", automated_login_sites=[\"instagram\"])\n```\n\n> You can set the `automated_login_sites` argument as whichever website you want to automatially login to.\n\nFor more use cases, check out the [examples](./examples) direcrtory.\n\nThis is useful in case of OSINT when you inevitably come across a profile that is hidden behind the login wall. Setting that field will trigger the login scripts to run after it verifies the site.\n\nIf you don't want to automatically login, don't set this value. The default behavior is to not do any such thing.\n\n- We also have an async endpoint if you need. That can be called using just `.run()`\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Automate online browsing using python and AI",
"version": "0.1.7",
"project_urls": null,
"split_keywords": [
"browser-automations",
" ai"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "66ebe5d259ab9d1a2443995d4cc55e16c91d92dfccd110cb77e8b0e0ebd077b6",
"md5": "bb5769bfceabd7f65487b9e062fd6229",
"sha256": "97bea724d4cd593152df131b28316c1c18224ea5d56747fbb0f6887c8532e3fe"
},
"downloads": -1,
"filename": "py_browser_automation-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bb5769bfceabd7f65487b9e062fd6229",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 32146,
"upload_time": "2025-10-26T21:01:07",
"upload_time_iso_8601": "2025-10-26T21:01:07.787289Z",
"url": "https://files.pythonhosted.org/packages/66/eb/e5d259ab9d1a2443995d4cc55e16c91d92dfccd110cb77e8b0e0ebd077b6/py_browser_automation-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "886fe278428b224b24b58234a860e61ccfffb4e93bb040bf8544376ed49910dd",
"md5": "e058cfd63a2529af8e6c9dd8472041fe",
"sha256": "ddb56117c1bd213637e48039950d9c9b66ed5d276e1282db912a4babc1a13894"
},
"downloads": -1,
"filename": "py_browser_automation-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "e058cfd63a2529af8e6c9dd8472041fe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 23554,
"upload_time": "2025-10-26T21:01:09",
"upload_time_iso_8601": "2025-10-26T21:01:09.755082Z",
"url": "https://files.pythonhosted.org/packages/88/6f/e278428b224b24b58234a860e61ccfffb4e93bb040bf8544376ed49910dd/py_browser_automation-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-26 21:01:09",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "py-browser-automation"
}
