==============================================================
  BizNode — Installation Guide
  Autonomous AI Business Operator
  https://biznode.1bz.biz
==============================================================


BEFORE YOU BEGIN — REQUIRED SOFTWARE
--------------------------------------

You must install the following TWO programs before running
BizNode. Both are free.


  STEP 1 — Install Python 3.10 or higher
  ----------------------------------------
  Download: https://www.python.org/downloads/

  During installation:
    [x] Check "Add Python to PATH"   <-- IMPORTANT
        (tick this box before clicking Install Now)

  To verify after install, open Command Prompt and type:
    python --version
  You should see: Python 3.11.x (or higher)


  STEP 2 — Install Docker Desktop
  ---------------------------------
  Download: https://www.docker.com/products/docker-desktop/

  During installation:
    - Accept all defaults
    - Enable WSL 2 integration if prompted (recommended)

  After install:
    - Launch Docker Desktop
    - Wait until it shows "Docker is running" (green icon in taskbar)
    - Keep Docker Desktop running during BizNode installation

  To verify, open Command Prompt and type:
    docker --version
  You should see: Docker version 24.x.x (or higher)


--------------------------------------------------------------
  MINIMUM SYSTEM REQUIREMENTS
--------------------------------------------------------------

  Operating System : Windows 10 / 11 (64-bit)
  RAM              : 8 GB minimum  (16 GB recommended)
  Disk Space       : 15 GB free    (Ollama AI models = 4-5 GB)
  Internet         : Required for setup and first registration
  GPU              : Optional — NVIDIA GPU speeds up AI responses


--------------------------------------------------------------
  INSTALLING BIZNODE
--------------------------------------------------------------

  STEP 3 — Extract BizNode.zip
  ------------------------------
  Right-click BizNode.zip and select "Extract All".
  Extract to any folder, e.g. C:\Users\YourName\BizNode

  STEP 4 — Run setup.bat (first time only)
  ------------------------------------------
  Open the extracted folder and double-click setup.bat.
  This will:
    - Check that Python and Docker are installed
    - Install all required Python packages (2-5 minutes)

  setup.bat only needs to be run ONCE on first install.


--------------------------------------------------------------
  FIRST RUN — REGISTRATION
--------------------------------------------------------------

  STEP 4 — Start BizNode
  ------------------------
  Open Command Prompt in your install folder and type:

    python launcher.py

  On your VERY FIRST run, BizNode will ask you to register:

    ============================================================
      BIZNODE - Registration Required
    ============================================================

      Business Name   : [your business name]
      Your Name       : [your name]
      Email Address   : [your email]
      Phone (optional): [your phone]
      City  (optional): [your city]
      Country         : [your country]

  Fill in the details and press Enter after each field.
  Registration is free and takes under a minute.

  After registration:
    - Your 10-day FREE TRIAL starts immediately
    - The BizNode dashboard opens at: http://localhost:7777
    - Your Telegram bot becomes active


--------------------------------------------------------------
  USING BIZNODE DURING TRIAL (Days 1-10)
--------------------------------------------------------------

  Every day, start BizNode with:
    python launcher.py

  Then open your browser to:
    http://localhost:7777

  The dashboard shows:
    [TRIAL] Trial active - X day(s) remaining.

  You will see a warning at 3 days remaining.


--------------------------------------------------------------
  AFTER TRIAL — LICENSE OPTIONS
--------------------------------------------------------------

  After 10 days, BizNode requires a license to continue.

  OPTION A — Basic License (Software Key)
  -----------------------------------------
  Cost     : One-time purchase
  Features : 1 bot, core features, server-validated
  Key      : BZN-XXXXX-XXXXX-XXXXX format

  To purchase:
    Visit  : https://biznode.1bz.biz
    Email  : biznode@1bz.biz

  After purchase you receive a license key.
  Save it to a file called .license_key in your BizNode folder:

    echo BZN-XXXXX-XXXXX-XXXXX > .license_key
    python launcher.py

  The key is validated against the BizNode license server
  and bound to your machine on first activation.


  OPTION B — Pro License (USB Hardware Key)
  -------------------------------------------
  Cost     : Premium purchase
  Features : Up to 5 bots, all 27 features, USB-bound
  Includes : BizChannel marketplace, video automation,
             Stripe payments, crypto wallet, admin tools,
             customer engagement, promo emails, and more

  After purchase you receive USB license files.
  Copy them to a USB drive and insert it before starting:

    python launcher.py

  BizNode will detect the USB automatically and start
  in Pro mode with no time limit.


--------------------------------------------------------------
  STARTING BIZNODE (DAILY USE)
--------------------------------------------------------------

  1. Make sure Docker Desktop is running (green icon)
  2. Open Command Prompt in your install folder
  3. Run:
       python launcher.py
  4. Open browser:
       http://localhost:7777

  To stop BizNode:
    Press Ctrl+C in the Command Prompt window
    Or run: docker compose down


--------------------------------------------------------------
  TROUBLESHOOTING
--------------------------------------------------------------

  Problem : "python is not recognized"
  Fix     : Re-install Python with "Add to PATH" ticked

  Problem : "Docker not found" or "Cannot connect to Docker"
  Fix     : Open Docker Desktop and wait for green icon

  Problem : Dashboard not opening at http://localhost:7777
  Fix     : Wait 30 seconds after launcher.py starts
            Check that port 7777 is not used by another app

  Problem : Registration fails
  Fix     : Check your internet connection
            Try again — server may be briefly unavailable

  Problem : Trial expired message
  Fix     : Purchase Pro license at https://biznode.1bz.biz

  Problem : Ollama models not downloading
  Fix     : First-run model download needs 4-5 GB free space
            and a stable internet connection (~30 min)


--------------------------------------------------------------
  SUPPORT
--------------------------------------------------------------

  Website  : https://biznode.1bz.biz
  Email    : biznode@1bz.biz
  Telegram : https://t.me/biznode_bot

  For fastest support, email with:
    - Your Registration ID (shown after first run)
    - Screenshot of the error message
    - Your Windows version (Settings > About)


==============================================================
  BizNode v1.0  |  1BZ DZIT DAO LLC  |  biznode.1bz.biz
==============================================================
