Skip to main content

A comprehensive, customizable, and scalable library for creating AI-enhanced checkout bots.

Project description

CheckoutBotFramework

Introduction

CheckoutBotFramework is a comprehensive framework for building AI-enhanced checkout bots. It provides a structured approach to automate the purchasing process on various e-commerce websites, especially those with limited-availability products. The framework includes reusable libraries for web scraping, automated checkout, CAPTCHA handling, proxy management, and notifications, as well as templates and tools for building and managing your bots.

Features

  • Reusable Libraries: Functions and modules for common tasks like web scraping and automated checkout.
  • Structured Approach: Templates and tools to guide you in building AI-enhanced checkout bots.
  • Configuration Interface: Web interface for configuring and managing your bots.
  • Extensibility: Easily extend the framework with your own logic and integrations.

Installation

To install the CheckoutBotFramework, follow these steps:

  1. Clone the repository:

    git clone https://github.com/Farzin312/checkout_bot.git
    cd checkout_bot
    
  2. Create a virtual environment and activate it:

    python -m venv my_env
    source my_env/bin/activate   # On Windows: my_env\Scripts\activate
    
  3. Install the required packages:

    pip install -r requirements.txt
    
  4. Set up environment variables: Create a .env file in the root directory and add the necessary environment variables:

    SECRET_KEY=your_secret_key
    

Usage

To use the CheckoutBotFramework, follow these steps:

  1. Start the Flask web application:

    python -m checkoutbot.ui.dashboard
    
  2. Open your web browser and navigate to http://127.0.0.1:5000/ to access the configuration interface.

  3. Configure your bot settings, payment information, and scraping details through the web interface.

  4. Save your configuration and start the bot.

For detailed usage instructions, refer to the usage guide.

Development

If you would like to contribute to the CheckoutBotFramework or extend its functionality, follow these steps:

  1. Fork the repository and clone it locally:

    git clone https://github.com/Farzin312/checkout_bot.git
    cd checkout_bot
    
  2. Create a new branch for your feature or bug fix:

    git checkout -b feature-name
    
  3. Make your changes and commit them:

    git add .
    git commit -m "Description of your changes"
    
  4. Push your changes to your fork:

    git push origin feature-name
    
  5. Create a pull request to merge your changes into the main repository.

For more details on development practices and guidelines, refer to the development guide.

Examples

The examples directory contains sample configuration files and scripts to help you get started with the framework.

  1. Example configuration files:

    • examples/config/example_config.json
    • examples/config/example_template1.json
    • examples/config/example_template2.json
  2. Example scripts:

    • examples/scripts/run_example_config.py
    • examples/scripts/run_template1.py
    • examples/scripts/run_template2.py
  3. Documentation for examples:

    • examples/docs/README.md

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For any inquiries or issues, please contact Farzin Shifat at farzinshifat@gmail.com.

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

checkout_bot-1.0.0.tar.gz (16.7 kB view details)

Uploaded Source

Built Distribution

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

checkout_bot-1.0.0-py3-none-any.whl (20.2 kB view details)

Uploaded Python 3

File details

Details for the file checkout_bot-1.0.0.tar.gz.

File metadata

  • Download URL: checkout_bot-1.0.0.tar.gz
  • Upload date:
  • Size: 16.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.5

File hashes

Hashes for checkout_bot-1.0.0.tar.gz
Algorithm Hash digest
SHA256 3d760daa2b7d0b66ae5b206acdedb4efb1fe726e3c0c13bd4692898e27e15cbc
MD5 65350b1ee333cc3db972120b2de87332
BLAKE2b-256 aa21a06b8c34aec17ab3c7a0a696b0fadd6b06aea04c47f7b73f6ebeda7bb076

See more details on using hashes here.

File details

Details for the file checkout_bot-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: checkout_bot-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 20.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.5

File hashes

Hashes for checkout_bot-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bd32dbdd66e14006e2e8aaeb6e5692bf249f6de708603893617f78e64d952b71
MD5 3cebf9d6833a688ba19d26b40409a826
BLAKE2b-256 affe433d17ab828f17d557dafd1b32053a34a08c73dbd2451af27ef4cca65359

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