Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/philippnormann/nvidia-sniper

🎯 Autonomously buy Nvidia Founders Edition GPUs as soon as they become available.
https://github.com/philippnormann/nvidia-sniper

automation bot checkout firefox nvidia python selenium sniper

Last synced: 3 months ago
JSON representation

🎯 Autonomously buy Nvidia Founders Edition GPUs as soon as they become available.

Awesome Lists containing this project

README 

        
# nvidia-sniper [![discord](https://img.shields.io/discord/756303724095471617.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/rks69fD) [![donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/PhilippNormann)



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](https://github.com/jef/streetmerchant) or [fairgame](https://github.com/Hari-Nagarajan/fairgame).



## Features



- Continuously monitor the availability of target GPU on www.nvidia.com

- Automatically checkout item using PayPal or as guest (credit card)

- Automatically submit the order for credit card payment

- Support for multiple locales (as defined in `config/customer.json`)

- Support for multiple GPUs (as defined in `data/gpus.json`)



screencast



## Contents



* [Features](#Features)

* [Supported GPUs](#Supported-GPUs)

* [Installation](#Installation)

  * [Linux (Ubuntu)](#Linux-(Ubuntu))

  * [Mac](#Mac)

  * [Windows](#Windows)

  * [CAPTCHA](#CAPTCHA)

* [Updating](#Updating)

* [Usage](#Usage)

* [Configuration](#Configuration)



## Supported GPUs



- GeForce RTX 3090

- GeForce RTX 3080

- GeForce RTX 3070

- NVIDIA TITAN RTX

- GeForce RTX 2080 Super

- GeForce RTX 2070 Super

- GeForce RTX 2060 Super



## Installation



To run the bot, we need the following things:



- Python 3.8

- Pipenv

- Firefox



### Linux (Ubuntu)

```bash

sudo apt install firefox python3 pipenv

cd nvidia-sniper

pipenv install

```



### Mac

1. Install the latest version of [Firefox](https://www.firefox.com/)

2. Install [brew](https://brew.sh/index_de) 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](https://www.python.org/ftp/python/3.8.6/python-3.8.6-amd64.exe) for Windows

    - Click `Add Path` at the bottom of the first installation page.

3. Install the latest version of [Firefox](https://www.firefox.com/)

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](https://addons.mozilla.org/en-US/firefox/addon/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](http://2captcha.com/?from=10326385). Deposit money into your account. A few :dollar: should be enough.

4. Start the bot as per the instructions in the [Usage](#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.



```bash

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:

- `pover://user@token`: Pushover

- `tgram://bottoken/ChatID`: Telegram

- `discord://webhook_id/webhook_token`: Discord



### `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:

- `de-at`: Austria

- `fr-be`: Belgium

- `en-ca`: Canada

- `cs-cz`: Czech Republic

- `da-dk`: Denmark

- `fi-fi`: Finland

- `fr-fr`: France

- `de-de`: Germany

- `it-it`: Italy

- `nl-nl`: Netherlands

- `nb-no`: Norway

- `pl-pl`: Poland

- `es-es`: Spain

- `sv-se`: Sweden

- `en-gb`: United Kingdom

- `en-us`: United States



### `speed`

The `speed` field can have the following values:

- `shippingOptionID2`: Standard Ground

- `shippingOptionID3`: Next Business day Afternoon

- `shippingOptionID4`: Second Business Day Afternoon



### `backup-speed`

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

- `true`: (Default) Fallback to using the standard shipping speed when the desired speed isn't available

- `false`: Stop the bot from continuing with checkout



### `country`

The `country` field can have the following values:

- `AT`: Austria

- `BE`: Belgium

- `CA`: Canada

- `CZ`: Czech Republic

- `DK`: Denmark

- `FI`: Finland

- `FR`: France

- `DE`: Germany

- `IT`: Italy

- `NL`: Netherlands

- `NO`: Norway

- `PL`: Poland

- `ES`: Spain

- `SE`: Sweden

- `GB`: United Kingdom

- `US`: United States



### `state`

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

- `AL`: Alabama

- `AK`: Alaska

- `AB`: Alberta

- `AS`: American Samoa

- `AZ`: Arizona

- `AR`: Arkansas

- `AA`: Armed Forces America

- `AE`: Armed Forces Europe

- `AP`: Armed Forces Pacific

- `BC`: British Columbia

- `CA`: California

- `CO`: Colorado

- `CT`: Connecticut

- `DE`: Delaware

- `DC`: District Of Columbia

- `FM`: Federated States of Micronesia

- `FL`: Florida

- `GA`: Georgia

- `GU`: Guam

- `HI`: Hawaii

- `ID`: Idaho

- `IL`: Illinois

- `IN`: Indiana

- `IA`: Iowa

- `KS`: Kansas

- `KY`: Kentucky

- `LA`: Louisiana

- `ME`: Maine

- `MB`: Manitoba

- `MH`: Marshall Islands

- `MD`: Maryland

- `MA`: Massachusetts

- `MI`: Michigan

- `MN`: Minnesota

- `MS`: Mississippi

- `MO`: Missouri

- `MT`: Montana

- `NE`: Nebraska

- `NV`: Nevada

- `NB`: New Brunswick

- `NH`: New Hampshire

- `NJ`: New Jersey

- `NM`: New Mexico

- `NY`: New York

- `NL`: Newfoundland and Labrador

- `NC`: North Carolina

- `ND`: North Dakota

- `MP`: Northern Mariana Islands

- `NT`: Northwest Territories

- `NS`: Nova Scotia

- `NU`: Nunavut

- `OH`: Ohio

- `OK`: Oklahoma

- `ON`: Ontario

- `OR`: Oregon

- `PW`: Palau

- `PA`: Pennsylvania

- `PE`: Prince Edward Island

- `PR`: Puerto Rico

- `QC`: Quebec

- `RI`: Rhode Island

- `SK`: Saskatchewan

- `SC`: South Carolina

- `SD`: South Dakota

- `TN`: Tennessee

- `TX`: Texas

- `UT`: Utah

- `VT`: Vermont

- `VI`: Virgin Islands

- `VA`: Virginia

- `WA`: Washington

- `WV`: West Virginia

- `WI`: Wisconsin

- `WY`: Wyoming

- `YT`: Yukon