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:
-
Clone the repository:
git clone https://github.com/Farzin312/checkout_bot.git cd checkout_bot
-
Create a virtual environment and activate it:
python -m venv my_env source my_env/bin/activate # On Windows: my_env\Scripts\activate
-
Install the required packages:
pip install -r requirements.txt
-
Set up environment variables: Create a
.envfile in the root directory and add the necessary environment variables:SECRET_KEY=your_secret_key
Usage
To use the CheckoutBotFramework, follow these steps:
-
Start the Flask web application:
python -m checkoutbot.ui.dashboard
-
Open your web browser and navigate to
http://127.0.0.1:5000/to access the configuration interface. -
Configure your bot settings, payment information, and scraping details through the web interface.
-
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:
-
Fork the repository and clone it locally:
git clone https://github.com/Farzin312/checkout_bot.git cd checkout_bot
-
Create a new branch for your feature or bug fix:
git checkout -b feature-name
-
Make your changes and commit them:
git add . git commit -m "Description of your changes"
-
Push your changes to your fork:
git push origin feature-name
-
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.
-
Example configuration files:
examples/config/example_config.jsonexamples/config/example_template1.jsonexamples/config/example_template2.json
-
Example scripts:
examples/scripts/run_example_config.pyexamples/scripts/run_template1.pyexamples/scripts/run_template2.py
-
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3d760daa2b7d0b66ae5b206acdedb4efb1fe726e3c0c13bd4692898e27e15cbc
|
|
| MD5 |
65350b1ee333cc3db972120b2de87332
|
|
| BLAKE2b-256 |
aa21a06b8c34aec17ab3c7a0a696b0fadd6b06aea04c47f7b73f6ebeda7bb076
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bd32dbdd66e14006e2e8aaeb6e5692bf249f6de708603893617f78e64d952b71
|
|
| MD5 |
3cebf9d6833a688ba19d26b40409a826
|
|
| BLAKE2b-256 |
affe433d17ab828f17d557dafd1b32053a34a08c73dbd2451af27ef4cca65359
|