This project is a Telegram bot that monitors and notifies the user about the status of Vast.ai instances. The primary functionality of the bot is to alert users immediately when there is an issue with their instances, such as when an instance stops working or has low GPU utilization. This allows users to quickly restart their Nimble cryptocurrency miners, preventing wasted GPU time and saving money.
Additionally, the bot offers functionalities such as:
- Checking the credit balance of Vast.ai accounts.
- Retrieving detailed information about instances.
- Monitoring GPU and CPU utilization.
- Checking the balance of a Nimble wallet.
User API keys for Vast.ai are encrypted and securely stored on the server to ensure privacy and security.
- API Key Management: Add or remove your Vast.ai API key.
- Instance Monitoring: Get detailed information about your Vast.ai instances.
- Credit Balance Check: Check your Vast.ai account credit balance.
- Nimble Wallet Management: Add, remove, and check the balance of your Nimble wallet.
- Automatic Notifications: Receive notifications when your instances have unusually low GPU or CPU usage.
- Secure Storage: User API keys are encrypted and securely stored on the server.
Watch the demo of the bot in action: Demo on YouTube
- Python
- Telegram Bot API
- Vast.ai API
- Nimble API
- dotenv
- requests
- subprocess
- logging
- threading
- Clone the repository:
git clone https://github.com/st00mp/vast-bot.git
- Navigate to the project directory:
cd vast-bot
- Install the dependencies:
pip install -r requirements.txt
- Configure the environment variables:
- Create a
.env
file in the project's root directory. - Add your Telegram token:
TELEGRAM_TOKEN=your_telegram_token
- Create a
- Start the bot:
python main.py
- Use the following commands in your Telegram chat with the bot:
/setapikey
: Set your Vast.ai API key./removeapikey
: Remove your Vast.ai API key./infos
: Get information about your Vast.ai instances./credit
: Check your Vast.ai account credit balance./setmasterwallet
: Set your Nimble master wallet address./removemasterwallet
: Remove your Nimble master wallet address./checknimbalance
: Check your Nimble wallet balance./start
: Display the help message.
-
Set API Key:
/setapikey
Then, send your API key in the chat.
-
Get Instance Information:
/infos
-
Check Credit Balance:
/credit
-
Set Nimble Wallet Address:
/setmasterwallet
Then, send your Nimble wallet address in the chat.
Contributions are welcome! Please submit a pull request or open an issue to discuss the changes you want to make.
- st00mp (https://github.com/st00mp)