Compare commits
No commits in common. "6a6336a07cf2ea5e6f86d4b21fa235999fec07a7" and "b0309f34fe0abf812fa8f9fc8bb3cf8b75d2007d" have entirely different histories.
6a6336a07c
...
b0309f34fe
30
LICENSE
30
LICENSE
@ -1,24 +1,14 @@
|
|||||||
Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
|
Non-Profit Open Software License 3.0 (NPOSL-3.0)
|
||||||
|
|
||||||
Copyright (c) 2025 Djeex
|
Copyright (C) 2025 Djeex - Nvidia Stock Bot
|
||||||
|
|
||||||
This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.
|
The NPOSL-3.0 is a free and open-source license, but it has restrictions.
|
||||||
|
You are allowed to:
|
||||||
|
- Use, copy, and modify the software for non-commercial purposes.
|
||||||
|
- Distribute the software, provided it remains free and non-commercial.
|
||||||
|
|
||||||
You are free to:
|
You are not allowed to:
|
||||||
|
- Use the software for commercial purposes.
|
||||||
|
- Modify the software and redistribute it under another license.
|
||||||
|
|
||||||
Share — copy, distribute, and transmit the material in any medium or format
|
Full text of the license can be found at: https://sourceforge.net/p/npdl/wiki/NPOSL_3_0/
|
||||||
|
|
||||||
Adapt — remix, transform, and build upon the material
|
|
||||||
|
|
||||||
Under the following terms:
|
|
||||||
|
|
||||||
Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
|
|
||||||
|
|
||||||
NonCommercial — You may not use the material for commercial purposes.
|
|
||||||
|
|
||||||
No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
|
|
||||||
|
|
||||||
You can review the full license here:
|
|
||||||
https://creativecommons.org/licenses/by-nc/4.0/
|
|
||||||
|
|
||||||
DISCLAIMER: This text does not constitute legal advice. For any legal questions, please consult a professional.
|
|
||||||
133
README.md
133
README.md
@ -1,93 +1,42 @@
|
|||||||
<h1 align="center"> Nvidia Stock Bot</h1>
|
# Nvidia Stock Bot
|
||||||
<div align="center">
|
Par KevOut & Djeex
|
||||||
<a href="https://discord.gg/gxffg3GA96">
|
|
||||||
<img src="https://img.shields.io/badge/JV%20hardware-rejoindre-green?style=flat-square&logo=discord&logoColor=%23fff" alt="JV Hardware">
|
|
||||||
<a href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank">
|
|
||||||
<img src="https://img.shields.io/badge/License-CC%20BY--NC%204.0-8E44AD?style=flat-square" alt="License: CC BY-NC 4.0">
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
<div align="center"><em>Le code a été en partie rédigé et structuré à l'aide d'une IA générative.</em>
|
|
||||||
</div>
|
|
||||||
<br>
|
|
||||||
|
|
||||||
**Nvidia Stock Bot** - Un robot qui permet d'être alerté en temps réel des stocks de cartes graphiques **Nvidia RTX FE** grâce à des notifications Discord.
|
*Ce projet est protégé par la license Non-Profit Open Software License 3.0 (NPOSL-3.0)*
|
||||||
|
*Le code a été en partie rédigé et structuré à l'aide d'une IA générative*
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p align="center">
|
[](https://discord.gg/gxffg3GA96) 
|
||||||
<img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvidia-stock-bot-discord.png" style="border-radius: 10px;" alt="Nvidia Stock Bot">
|
|
||||||
</p>
|
|
||||||
|
|
||||||
## Sommaire
|
Bot qui permet d'être alerté des stocks de Nvidia RTX FE.
|
||||||
|
|
||||||
- [Fonctionnalités](#fonctionnalit%C3%A9s)
|
<img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvidia-stock-bot-discord.jpg" align="center">
|
||||||
- [Installation docker sans le dépot (rapide)](#installation-sans-le-d%C3%A9pot-avec-docker-compose)
|
|
||||||
- [Installation docker avec le dépot (développeur)](#installation-avec-le-d%C3%A9pot)
|
|
||||||
- [Installation avec Python (développeur)](#installation-avec-python)
|
|
||||||
|
|
||||||
## Fonctionnalités
|
|
||||||
|
|
||||||
- Notification Discord `@everyone` en cas de changement du SKU (potentiel drop imminent)
|
Ce robot :
|
||||||
- Notification Discord `@everyone` en cas de stock détecté avec modèle, prix, et lien
|
- Appelle l'API de Nvidia listant le produit (par défaut toutes les 60s)
|
||||||
- Notification Discord silencieuse en cas d'absence de stock détécté
|
- Récupère le SKU du produit concerné
|
||||||
- Choix de la fréquence de la vérification
|
- Appelle le stock lié à ce SKU
|
||||||
- Choix du modèle à surveiller
|
- Si du stock est trouvé, envoie une notification discord via le webhook paramétré
|
||||||
|
- Si le produit était déjà en stock, il n'envoie plus de notification
|
||||||
|
- Si le produit était en stock mais ne l'est plus, envoie une notification discord signifiant la fin du stock
|
||||||
|
- Si le SKU change, une notification est envoyée alertant de l'éventuelle imminence du drop
|
||||||
|
|
||||||
<img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvbot.png" align="center">
|
<img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvbot.png" align="center">
|
||||||
|
|
||||||
## Installation sans le dépot avec docker compose
|
Trois modes d'installation :
|
||||||
|
- [Avec le dépot Git et Docker](https://git.djeex.fr/Djeex/nvidia-stock-bot/#installation-avec-le-d%C3%A9pot)
|
||||||
Vous trouverez-ci dessous les instructions pour configurer le conteneur avec notre image pré-compilée. Avec cette solution, votre bot tournera tout seul tant que le conteneur est actif.
|
- [Sans le dépot Git et avec notre image docker fournie](https://git.djeex.fr/Djeex/nvidia-stock-bot/#installation-sans-le-d%C3%A9pot-avec-docker-compose)
|
||||||
|
- [Avec python (développeurs)](https://git.djeex.fr/Djeex/nvidia-stock-bot/#installation-sans-le-d%C3%A9pot-avec-docker-compose)
|
||||||
**Pré-requis**
|
|
||||||
- [Docker](https://docs.docker.com/engine/install/)
|
|
||||||
|
|
||||||
**Configuration**
|
|
||||||
|
|
||||||
- Créez un dossier `nvidia-stock-bot`
|
|
||||||
- Créez le fichier `compose.yaml` dans ce dossier avec la configuration ci-dessous :
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
version: "3.8"
|
|
||||||
services:
|
|
||||||
nvidia-stock-bot:
|
|
||||||
image: git.djeex.fr/djeex/nvidia-stock-bot:latest
|
|
||||||
container_name: nvidia-stock-bot
|
|
||||||
restart: always
|
|
||||||
environment:
|
|
||||||
- DISCORD_WEBHOOK_URL= # URL de votre webhook Discord
|
|
||||||
- REFRESH_TIME= # Durée de rafraichissement du script en secondes
|
|
||||||
- API_URL_SKU= # API listant le produit par exemple https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205090
|
|
||||||
- API_URL_STOCK= # API appelant le stock sans préciser la valeur du sku, par exemple https://api.store.nvidia.com/partner/v1/feinventory?locale=fr-fr&skus=
|
|
||||||
- PRODUCT_URL= # URL d'achat du GPU
|
|
||||||
- PRODUCT_NAME= # Le nom du GPU qui s'affiche dans les notifications
|
|
||||||
- TEST_MODE= # true pour tester les notifications discord. false par défaut.
|
|
||||||
- PYTHONUNBUFFERED=1 # Permet d'afficher les logs en temps réel
|
|
||||||
command: python nvidia-stock-bot.py # Lance le script Python au démarrage du conteneur
|
|
||||||
```
|
|
||||||
|
|
||||||
**Lancer l'image**
|
|
||||||
|
|
||||||
Rendez-vous dans le dossier `nvidia-stock-bot` et lancez le conteneur :
|
|
||||||
```sh
|
|
||||||
docker compose up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
**Voir les logs pour vérifier le bon fonctionnement**
|
|
||||||
|
|
||||||
```sh
|
|
||||||
docker logs -f nvidia-stock-bot
|
|
||||||
```
|
|
||||||
|
|
||||||
## Installation avec le dépot
|
## Installation avec le dépot
|
||||||
|
|
||||||
Vous trouverez-ci dessous les instructions pour installer le dépot, compiler l'image docker, et lancer le conteneur. Avec cette solution, votre bot tournera tout seul tant que le conteneur est actif.
|
Vous trouverez-ci dessous les instructions pour installer le dépot, compiler l'image docker, et lancer le conteneur. Avec cette solution, votre bot tournera tout seul tant que le conteneur est actif.
|
||||||
|
|
||||||
**Pré-requis**
|
### Pré-requis
|
||||||
- [Git](https://git-scm.com/docs)
|
- Git
|
||||||
- [Docker](https://docs.docker.com/engine/install/)
|
- Docker
|
||||||
|
|
||||||
**Cloner et paramétrer**
|
### Cloner et paramétrer
|
||||||
|
|
||||||
Clonez le repo :
|
Clonez le repo :
|
||||||
```sh
|
```sh
|
||||||
@ -104,29 +53,57 @@ Rendez-vous dans le dossier `nvidia-stock-bot/docker` et éditez le fichier `.en
|
|||||||
- les différents liens API et produits
|
- les différents liens API et produits
|
||||||
- la fréquence de consultation des stock (par défaut 60s, attention à ne pas trop descendre sous peine de blocage de votre adresse IP par nVidia)
|
- la fréquence de consultation des stock (par défaut 60s, attention à ne pas trop descendre sous peine de blocage de votre adresse IP par nVidia)
|
||||||
|
|
||||||
**Lancer l'image**
|
### Lancer l'image
|
||||||
|
|
||||||
Rendez-vous dans le dossier `nvidia-stock-bot/docker` et lancez le conteneur :
|
Rendez-vous dans le dossier `nvidia-stock-bot/docker` et lancez le conteneur :
|
||||||
```sh
|
```sh
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
```
|
```
|
||||||
|
|
||||||
**Voir les logs pour vérifier le bon fonctionnement**
|
### Voir les logs pour vérifier le bon fonctionnement
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
docker logs -f nvidia-stock-bot
|
docker logs -f nvidia-stock-bot
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Installation sans le dépot avec docker compose
|
||||||
|
|
||||||
|
Vous trouverez-ci dessous les instructions pour configurer le conteneur avec notre image pré-compilée. Avec cette solution, votre bot tournera tout seul tant que le conteneur est actif.
|
||||||
|
|
||||||
|
### Pré-requis
|
||||||
|
- Docker
|
||||||
|
|
||||||
|
### Configuration
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
version: "3.8"
|
||||||
|
services:
|
||||||
|
nvidia-stock-bot:
|
||||||
|
image: git.djeex.fr/djeex/nvidia-stock-bot:latest
|
||||||
|
container_name: nvidia-stock-bot
|
||||||
|
restart: always # Le conteneur redémarrera automatiquement en cas d'échec
|
||||||
|
environment:
|
||||||
|
- DISCORD_WEBHOOK_URL= # URL de votre webhook Discord
|
||||||
|
- REFRESH_TIME= # Durée de rafraichissement du script en secondes
|
||||||
|
- API_URL_SKU= # API listant le produit par exemple https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205090
|
||||||
|
- API_URL_STOCK= # API appelant le stock sans préciser la valeur du sku, par exemple https://api.store.nvidia.com/partner/v1/feinventory?locale=fr-fr&skus=
|
||||||
|
- PRODUCT_URL= # URL d'achat du GPU
|
||||||
|
- PRODUCT_NAME= #Le nom du GPU qui s'affiche dans les notifications
|
||||||
|
- TEST_MODE= #true pour tester les notifications discord. false par défaut.
|
||||||
|
- PYTHONUNBUFFERED=1 # Permet d'afficher les logs en temps réel
|
||||||
|
command: python nvidia-stock-bot.py # Lance le script Python au démarrage du conteneur
|
||||||
|
```
|
||||||
|
|
||||||
## Installation avec Python
|
## Installation avec Python
|
||||||
|
|
||||||
Vous trouverez ci-dessous comment exécuter directement le script Python. Avec cette solution, le bot s'arretera si vous fermez votre terminal.
|
Vous trouverez ci-dessous comment exécuter directement le script Python. Avec cette solution, le bot s'arretera si vous fermez votre terminal.
|
||||||
|
|
||||||
**Pré-requis**
|
### Pré-requis
|
||||||
|
|
||||||
- Python 3.11 ou plus
|
- Python 3.11 ou plus
|
||||||
- requests : `pip install requests`
|
- requests : `pip install requests`
|
||||||
|
|
||||||
**Configuration**
|
### Configuration
|
||||||
|
|
||||||
- Créez un environnement virtuel (exemple : `python3 -m venv nom_de_l_environnement` )
|
- Créez un environnement virtuel (exemple : `python3 -m venv nom_de_l_environnement` )
|
||||||
- Créez un dossier et aller dedans
|
- Créez un dossier et aller dedans
|
||||||
|
|||||||
BIN
assets/img/nvidia-stock-bot-discord.jpg
Normal file
BIN
assets/img/nvidia-stock-bot-discord.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 171 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 170 KiB |
12
docker/.env
12
docker/.env
@ -1,6 +1,6 @@
|
|||||||
DS_HOOK= #votre url du webhook Discord
|
DS_HOOK= #votre url du webhook Discord
|
||||||
FREQ= #frequence de rafraichissement en secondes
|
FREQ= #frequence de rafraichissement en secondes
|
||||||
API_URL_SKU= # API listant le produit par exemple https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205090
|
API_URL_SKU= # API listant le produit par exemple https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205090
|
||||||
API_URL_STOCK= # API appelant le stock sans préciser la valeur du sku, par exemple https://api.store.nvidia.com/partner/v1/feinventory?locale=fr-fr&skus=
|
API_URL_STOCK= # API appelant le stock sans préciser la valeur du sku, par exemple https://api.store.nvidia.com/partner/v1/feinventory?locale=fr-fr&skus=
|
||||||
PRODUCT_URL= # URL d'achat du GPU
|
PRODUCT_URL= # URL d'achat du GPU
|
||||||
PRODUCT_NAME= #Le nom du GPU qui s'affiche dans les notifications
|
PRODUCT_NAME= #Le nom du GPU qui s'affiche dans les notifications
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user