Skip to main content

Automate online browsing using python and AI

Project description

PyBA - Python Browser Automations

This is a no-code 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 inputs (though it supports both through different modes).

Features

  • Trace zip file creation to recreate the automation for playwright traceviewer
  • Logger and dependency management automatically
  • Creation of the automation script in file once successful
  • Local and server based database creation for holding all the actions performed
  • Stealth mode and config heavy files for custom bypass laws
  • Quick login to social media sites without passing credentials to the LLM

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 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. We also support logging and config files should you want to change any defaults

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:

pip install py-browser-automation

or you can install it from the source:

git clone https://github.com/FauvidoTechnologies/PyBrowserAutomation/
cd PyBrowserAutomation
pip install .

Usage (quickstart)

[!NOTE] For more detailed instructions visit the docs

  • Import the main engine using:
from pyba import Engine
  • Set the right configurations depending on which model you want to use:

For VertexAI

engine = Engine(vertexai_project_id="", vertexai_server_location="", handle_dependencies=False)

For OpenAI

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()

engine.sync_run(prompt="open instagram")

For more use cases, check out the evals direcrtory.


If the software has helped, consider giving us a star!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py_browser_automation-0.2.2.tar.gz (38.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

py_browser_automation-0.2.2-py3-none-any.whl (55.8 kB view details)

Uploaded Python 3

File details

Details for the file py_browser_automation-0.2.2.tar.gz.

File metadata

  • Download URL: py_browser_automation-0.2.2.tar.gz
  • Upload date:
  • Size: 38.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for py_browser_automation-0.2.2.tar.gz
Algorithm Hash digest
SHA256 50fd02a96d473f22c5aa48cc5e65107313c1384a6963549f36ba3f0e8451bf2e
MD5 dbec515d2c4dfeb67f2fe01b47771441
BLAKE2b-256 0e71e393c5f5cf615bd3d050b48858159761011a90e12f090e5eb6a0e0f8b3c0

See more details on using hashes here.

File details

Details for the file py_browser_automation-0.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for py_browser_automation-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 11a93a03df406dbafb7295747e6301441e0f31df5254b31b1a563e709979863a
MD5 dbc32c267822171eb20c20bffbc922e9
BLAKE2b-256 26486564930b328f7ed625f9266ad847f3a55d235e5bf634b093a10c8a6a0ab4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page