search

philippnormann / nvidia-sniper

🎯 Autonomously buy Nvidia Founders Edition GPUs as soon as they become available.
396 stars 99 forks source link
automation bot checkout firefox nvidia python selenium sniper

readme

nvidia-sniper discord donate

This bot helps us buy Nvidia Founders Edition GPUs as soon as they become available.

Note: This project is no longer being actively maintained. Nvidia stopped selling Founders Edition cards through their own store and transitioned to exclusively selling via 3rd-party retailers. To buy from those 3rd-party retailers, you can check out other projects like streetmerchant or fairgame.

Features

screencast

Contents

Supported GPUs

Installation

To run the bot, we need the following things:

Linux (Ubuntu)

sudo apt install firefox python3 pipenv
cd nvidia-sniper
pipenv install

Mac

  1. Install the latest version of Firefox
  2. Install brew package manager
  3. Install Pipenv using
    • brew install pipenv
  4. Navigate to project directory using
    • cd nvidia-sniper
  5. Install project dependencies using
    • pipenv install

Windows

  1. Check if you already have a Python 3.8 installation by opening Windows PowerShell and executing python --version
    • If you see Python 3.8.0 or higher, skip to step 4, otherwise continue to step 2
  2. Install the latest Python 3.8 for Windows
    • Click Add Path at the bottom of the first installation page.
  3. Install the latest version of Firefox
  4. Exit all PowerShell windows, then open a new PowerShell and install Pipenv using
    • pip install pipenv
  5. Navigate to project directory
    • If you downloaded (using git clone, or ZIP and extract) the project to C:\Users\user\Documents\nvidia-sniper, then use the following command: cd C:\Users\user\Documents\nvidia-sniper
  6. Install project dependencies using
    • pipenv install

  7. Install curses for Windows using

    • pipenv install windows-curses
      If step 6 results in `pipenv : The term 'pipenv' is not recognized`
    1. Setup a virtual environment using
      • python -m venv .venv
    2. Ensure you have the latest Python version using
      • python -m venv --upgrade .venv
    3. Activate the virtual environment using
      • .venv/Scripts/activate
    4. Install pipenv again using
      • pip install pipenv
    5. Install project dependencies using
      • pipenv install
    6. Install curses for Windows using
      • pipenv install windows-curses
If you get `python : The term 'python' is not recognized` even after installing Python 3.8 1. Open the Start menu and enter `PATH`, then press Enter 2. Click the `Environment Vairables...` button 3. In the `User variables for user` section, click the variable `Path`, then click the `Edit...` button 4. A new window called `Edit environment variable` will pop up, ensure `C:\Users\\AppData\Local\Programs\Python\Python38\Scripts` and `C:\Users\\AppData\Local\Programs\Python\Python38` exists in this list, where `` is your username in Windows 5. If these paths are not in the list, add them using the `New` button 6. Remove all other PATHs which contain anything to do with Python, Pip, or Idle by clicking them, then clicking the `Delete` button 7. Click `OK` to close the `Edit environment variable` window 8. Click `OK` to close the `Environment Variables` window 9. Click `OK` to close the `System Properties` window

CAPTCHA

This bot is equipped with the ability to resolve simple reCAPTCHA on its own without the use of a third party reCAPTCHA solver. As long as you follow the recommendation in the usage section below, it is extremely likely that the bot will succesfully complete the full auto-checkout process. With that said, there is a very small possibility that you will be presented with a more advanced reCAPTCHA requiring solving image tasks that the bot cannot handle natively. If you would like to have a backup in place for that possibility, you have that option by following the steps below.

  1. Download the ReCaptcha Solver extension using the link https://addons.mozilla.org/firefox/downloads/file/3423472/recaptcha_solver-5.7-fx.xpi. If you open this link in Firefox, it will automatically attempt to add the extension to your browser. That's not what we want. Right click the link and select "Save link as" to download the *.xpi file or try opening the link in a browser other than Firefox.

  2. Put the *.xpi file inside the root of the nvidia-sniper directory.

    folder

  3. Create an account using one of ReCaptcha Solver's supported APIs, ex. 2captcha. Deposit money into your account. A few :dollar: should be enough.

  4. Start the bot as per the instructions in the Usage section. After you go through the bot's selection process, you should see the ReCaptcha Solver extension in the browser.

  5. Copy your API key from the provider of your choice. Add this key to the extension. Also, enable the checkboxes as shown below.

    ReCaptcha Solver

Updating

To update nvidia-sniper use, git pull or download a fresh .zip archive from GitHub.

Make sure to back up the customer.json in advance as it might get replaced in the process.

Usage

To use the bot, fill out config/customer.json and run the script.

cd nvidia-sniper
pipenv run python -m sniper

It is highly recommended that you use Firefox as your default browser and use it to log into Google services such as YouTube or Gmail. This dramatically reduces the possibility of reCAPTCHA requiring you to pass an image challenge during the bot's operation, thus enabling a fully automatic checkout without the need for manual intervention.

Configuration

In the config folder a customer.json file and notifications.json file are used to configure the data used to auto fill the forms and to configure the bots notifications. To get started, copy and rename the two template files and customize the fields to your liking.

notifications.json

The bot can send multiple push notifications, including a screenshot attachment along the checkout process. See https://github.com/caronc/apprise#supported-notifications for more information. Add additional entries to the services dictionary in the notifications.json file for multiple providers. For each notification, a custom message can be set. Additionally, the screenshot attachment can be toggled per provider.

A couple of example URLs for different notification services:

customer.json

In the customer.json file you can configure your locale and the field contents used for auto-filling the checkout forms. Some fields require specific values.

locale

The locale field can have the following values:

speed

The speed field can have the following values:

backup-speed

There has been a common issue related to shipping speeds not being available when cards are available.

country

The country field can have the following values:

state

For en-us and en-ca locale, the state field can have the following values: