MasterCryptoFarmBot

MasterCryptoFarmBot CLI — Universal crypto farming bot manager with multi-bot orchestration, automated Telegram mini-app farming, session management, proxy support, scheduling system, Rich terminal dashboard, and one-click deployment for airdrop and DeFi yield farming

 __  __           _             _____                  _        ______                   ____        _   
 |  \/  |         | |           / ____|                | |      |  ____|                 |  _ \      | |  
 | \  / | __ _ ___| |_ ___ _ __| |     _ __ _   _ _ __ | |_ ___ | |__ __ _ _ __ _ __ ___ | |_) | ___ | |_ 
 | |\/| |/ _` / __| __/ _ \ '__| |    | '__| | | | '_ \| __/ _ \|  __/ _` | '__| '_ ` _ \|  _ < / _ \| __|
 | |  | | (_| \__ \ ||  __/ |  | |____| |  | |_| | |_) | || (_) | | | (_| | |  | | | | | | |_) | (_) | |_
 |_|  |_|\__,_|___/\__\___|_|   \_____|_|   \__, | .__/ \__\___/|_|  \__,_|_|  |_| |_| |_|____/ \___/ \__|
                                             __/ | |                                                      
                                            |___/|_|

Console Interface for Telegram Air-Drop Farming Platform

CLI launcher for MasterCryptoFarmBot — the foundational system for building crypto farming and airdrop bots for Telegram-based games. Manage settings, modules, and dependencies from a single Rich-powered console.

Getting Started · Features · Configuration · Usage · FAQ

</div>

Features

CLI Capabilities

Install dependencies from requirements.txt
Configure API type (WebQuery / Pyrogram / Telethon)
Toggle auto-update and multi-threading
Browse available bot modules
Launch main bot (requires full setup)
Check for updates
Access tutorial links

</td> <td width="50%">

Platform Integration

Modular design — add Hamster Kombat, Blum, Zoo, NotPixel, PAWS, and more
Unified farming from multiple Telegram bots
Web-based GUI (full platform)
Multi-threaded bot execution
Free and paid module support

</td> </tr> </table>

Getting Started

Prerequisites

Python 3.8 or higher (download)
pip (included with Python)
Full MasterCryptoFarmBot setup for Run Bot (see GitHub Wiki)

Installation

Option A — Windows (one-click):

Double-click run.bat — it installs dependencies and starts the CLI.

Option B — Manual (all platforms):

git clone https://github.com/masterking32/MasterCryptoFarmBot.git
cd MasterCryptoFarmBot
pip install -r requirements.txt
python main.py

For this CLI-only variant:

cd MasterCryptoFarmBot-CLI
pip install -r requirements.txt
python main.py

Dependencies

| Package | Version | Purpose | |---------|---------|---------| | rich | ≥ 13.0 | Terminal UI, panels, tables, prompts |

Configuration

`config/settings.json` — CLI and Platform Settings

Created automatically on first run. Controls API backend, auto-update, and threading.

{
  "api_type": "Pyrogram",
  "auto_update": true,
  "multi_threading": true
}

| Key | Values | Description | |-----|--------|-------------| | api_type | WebQuery, Pyrogram, Telethon | Telegram API library for the main platform | | auto_update | true, false | Enable automatic project and module updates | | multi_threading | true, false | Run multiple bots simultaneously |

Use option 2 (Settings) from the CLI menu to edit these values interactively.

Usage

python main.py

CLI menu mockup:

╔══════════════════════════════════════════════════════════════════╗
║                    MasterCryptoFarmBot CLI                       ║
║         Central platform for managing Telegram Air-Drop bots     ║
╚══════════════════════════════════════════════════════════════════╝

  ╭─────────────────────────────────────╮
  │  1   Install Dependencies           │
  │  2   Settings                       │
  │  3   About                           │
  │  4   Available Modules              │
  │  5   Run Bot                         │
  │  6   Check Updates                   │
  │  7   Tutorial                        │
  │  0   Exit                            │
  ╰─────────────────────────────────────╯

  Your choice (0-7):

| Option | Description | |:------:|-------------| | 1 | Installs Python dependencies from requirements.txt via pip | | 2 | Edit API type, auto-update, and multi-threading in config/settings.json | | 3 | Project info, features, links, donation addresses | | 4 | List available modules (Hamster Kombat, Blum, Zoo, NotPixel, PAWS, etc.) | | 5 | Launch main bot — requires full MasterCryptoFarmBot installation | | 6 | Check for project and module updates | | 7 | Links to video tutorial and GitHub Wiki | | 0 | Exit the CLI |

Project Structure

MasterCryptoFarmBot-CLI/
├── main.py              Entry point — Rich CLI menu and handlers
├── requirements.txt     Python dependencies (rich)
├── run.bat              Windows one-click launcher
├── config/
│   └── settings.json    API type, auto-update, multi-threading
├── about/
│   └── hashtags.txt     Project hashtags and metadata
└── README.md            This file

FAQ

<details> <summary><b>ModuleNotFoundError: No module named 'rich'</b></summary>

Run option 1 from the menu or manually:

pip install -r requirements.txt

</details> <details> <summary><b>Run Bot says "requires full MasterCryptoFarmBot setup"</b></summary>

This CLI is a launcher for the main platform. Clone the full MasterCryptoFarmBot repository and follow the GitHub Wiki for complete installation.

</details> <details> <summary><b>Which API type should I use: WebQuery, Pyrogram, or Telethon?</b></summary>

Pyrogram — recommended for most users, modern and well-maintained
Telethon — alternative with strong async support
WebQuery — for WebView-based Telegram interactions

Check the Wiki for setup details per API.

</details> <details> <summary><b>Where do I get modules like Hamster Kombat or Blum?</b></summary>

Modules are installed via the full MasterCryptoFarmBot platform. Some modules (e.g. MCF_HamsterKombat, MCF_Blum) are separate repositories. See the Available Modules section on GitHub.

</details> <details> <summary><b>Can I run this on Linux or macOS?</b></summary>

Yes. Use the manual installation path. On Linux:

python3 main.py

</details> <details> <summary><b>Settings not saving</b></summary>

Ensure config/ exists and is writable. The CLI creates it automatically. On first run, choose option 2 and change any setting to generate config/settings.json.

</details>

Disclaimer

This tool is for educational and testnet purposes only. Using bots is forbidden in most crypto air-drops. The authors cannot guarantee that you will not be detected. Use at your own risk. The authors are not responsible for any consequences of using this software.

Support the project

EVM-compatible (ETH, BSC, Base, Arbitrum):

0x517f07305D6ED781A089322B6cD93d1461bF8652

TON: masterking32.ton · TRC20: TLApdY8APWkFHHoxebxGY8JhMeChiETqFH

If you find this project useful, consider giving it a star on GitHub

</div>

MasterCryptoFarmBot

Install / Use

README

MasterCryptoFarmBot

Console Interface for Telegram Air-Drop Farming Platform

Features

Getting Started

Prerequisites

Installation

Dependencies

Configuration

config/settings.json — CLI and Platform Settings

Usage

Project Structure

FAQ

Disclaimer

`config/settings.json` — CLI and Platform Settings