FunPay Viper Framework

Intuitive and Potent Automation for FunPay Operations

We strongly advise joining our dedicated Telegram Support Community (Click Here) for assistance and discussion.

:clipboard: Table of Contents

• Features Overview

  • FunPay Core Interfacing
  • Telegram Alerting and Remote Control
  • Extensibility & Extras

• Advantages Profile

  • For End-Users
  • For Software Developers

• Modular Extensions (Plugins)

• Deployment Guide
  • Windows Environment
  • Linux (Ubuntu) Environment
• Plugin Installation Procedure
• Seeking Support
• Project Endorsement

:robot: Features Overview

:shopping_cart: FunPay Core Interfacing

• Automated product fulfillment/delivery sequence.
• Continuous, scheduled renewal of active sales listings.
• Predefined command responses for immediate query resolution.
• Automatic restocking/relisting of items post-transaction.
• Deactivation of listings when inventory reaches zero.
• Maintenance of perpetual 'Online' status presence.
• Integration for receiving system notifications directly in Telegram.
• Comprehensive remote operational console accessible via Telegram.

:left_speech_bubble: Telegram Alerts and Remote Control

• Support for configuring alerts across multiple designated Telegram chat instances.
• Notifications triggered by listing refreshes.
• Alerts for newly initiated purchase orders.
• Confirmation notifications upon successful item delivery.
• Incoming message alerts within the FunPay platform.
• Capability to issue direct replies to messages from within the Telegram interface.
• Fine-grained configuration options for auto-delivery logic, auto-responder rules, and all other Viper modules.
• Facility to define specific auto-delivery rules per listing, sourcing item status directly from FunPay.

:gear: Extensibility & Extras

• Utilization of runtime variables within automated response and delivery text templates.
• A plugin architecture enabling functional customization without modifying the core Viper source code.

:1st_place_medal: Advantages Profile

:grinning: For End-Users

• Superiority in feature set beyond fundamental requirements.
• Efficiency. Minimal system footprint: ~20MB disk space, peak usage around 50MB RAM, standard network access suffices.
• Cross-platform compatibility: Deployable on any system supported by the underlying execution environment (Python: Windows, Linux, macOS, Android, etc.).
• The plugin system grants extensive versatility for tailoring default behaviors to specialized operational demands.
• Configuration structures are both flexible and straightforward, utilizing the INI format.
• Commitment to regular maintenance, rapid bug resolution, and active incorporation of user-suggested features.
• Complete operational management accessible solely through Telegram.

:computer: For Software Developers

• Selection of Python, an optimally powerful yet approachable language for this class of application.
• Thorough internal code documentation. All classes, methods, and functions include docstrings and type hints.
• Strong adherence to Object-Oriented Programming (OOP) principles; most system events (e.g., orders, messages) are instantiated as class objects rather than simple data structures.
• Simplified development path for creating custom extensions.
• Robust, pre-configured logging mechanism; reliance on structured logging over simple console output (print).
• Independent Python package release (FunPayAPI), decoupled from the main FunPay Viper repository.
• Direct personal developer support provided.

:electric_plug: Modular Extensions (Plugins)

• Official Plugin Repository Channel

:arrow_down: Deployment Guide

Virtual Private Server rental is recommended via providers like FirstByte. Target an Ubuntu distribution version 20 or newer; other hardware specifications are non-critical.

:large_blue_diamond: Windows

1. Download and install Python.
   1. Crucially, ensure the checkbox for Add python.exe to PATH is selected during the initial setup screen.
2. Fetch the source archive: FunPay Viper
3. Extract the FunPayViper-main folder to the desired location.
4. Navigate into the FunPayViper-main directory.
5. Execute the setup batch file: Setup.bat. Wait for all requisite packages to resolve and install.
6. Close the terminal window and launch the primary application via Start.bat.

:hotsprings: Linux (Ubuntu)

1. Execute the following command sequence: wget https://raw.githubusercontent.com/FunPayViper/FunPayViper/main/install-fpv.sh -O install-fpv.sh && bash install-fpv.sh
2. Adhere to the prompts provided by the automated installation script. This script handles dependency installation and initializes the bot as a persistent background service.

Troubleshooting: latin-1 Encoding Issues

If you encounter errors referencing latin-1 encoding, execute the following locale configuration sequence:

1. Execute command: sudo apt-get install language-pack-ru
2. Execute command: sudo apt-get install language-pack-gnome-ru
3. Execute command: sudo apt-get install language-pack-kde-ru
4. Execute command: exit
5. Re-establish your connection to the server.
6. Execute command: sudo update-locale LANG=ru_RU.utf8
7. If an error persists, return to step 4 (reconnect).
8. Re-attempt the deployment script execution: wget https://raw.githubusercontent.com/FunPayViper/FunPayViper/main/install-fpv.sh -O install-fpv.sh && bash install-fpv.sh
9. If issues remain, repeat step 4 (reconnect).

:electric_plug: Plugin Installation Procedure

Security Warning: Exercise caution when installing modules from unverified external sources. The plugin mechanism grants extensive access, potentially compromising your FunPay credentials or host system.

Installation is straightforward:

1. Send the command /menu within the bot's Telegram dialogue.
2. Select the button labeled ▶️ Next.
3. Select the button labeled 🧩 Plugins.
4. Select the button labeled ➕ Add Plugin.
5. Forward or send the plugin file directly to the bot interface.

:question: Seeking Support

Should any aspect of the application remain unclear, our community awaits to assist you in our Telegram Support Channel.

:star: Project Endorsement

If FunPay Viper enhances your operational efficiency, kindly consider showing appreciation by clicking the :star: star icon :star: located in the upper-right corner of the GitHub repository page (requires GitHub login).