From 1409a07ed11e2cff406474902355a84d06d14b50 Mon Sep 17 00:00:00 2001
From: John Doe <johndoe@example.com>
Date: Sat, 18 Apr 2026 18:04:58 +0800
Subject: [PATCH] docs: add quick start guide with start/stop scripts and
 .env.example

---
 .env.example |  16 ++++++++
 README.md    | 114 +++++++++++++++++++++++++++------------------------
 2 files changed, 77 insertions(+), 53 deletions(-)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..94294f6
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,16 @@
+# WeatherBet Bot Configuration
+# Copy this file to .env and fill in your actual values
+
+# ===== Polygon Wallet =====
+# Your Polygon private key (hex format, without 0x prefix)
+PK=your_polygon_private_key_here
+
+# Your Polygon wallet address
+WALLET=0xYourWalletAddressHere
+
+# Signature type (0 = EOA, 1 = PolyProxy, 2 = Ledger)
+SIG_TYPE=0
+
+# ===== Polymarket =====
+# Optional: Polymarket API credentials (leave empty if not using)
+# VC_KEY=your_vc_key_here
diff --git a/README.md b/README.md
index 09bc296..c18ab78 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,66 @@ The bot monitors **6 US cities** (NYC, Chicago, Miami, Dallas, Seattle, Atlanta)
 
 ---
 
+## 🚀 Quick Start
+
+### 1. Clone & Install
+
+```bash
+git clone https://github.com/nicolastinkl/hermes_weatherbot.git
+cd hermes_weatherbot
+python3.13 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+```
+
+### 2. Configure
+
+Copy the example env file and fill in your wallet credentials:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env`:
+
+```env
+# Your Polygon private key (hex, without 0x prefix)
+PK=your_polygon_private_key_here
+
+# Your Polygon wallet address
+WALLET=0xYourWalletAddressHere
+
+# Signature type (0 = EOA)
+SIG_TYPE=0
+```
+
+Edit `config.json` to set your trading parameters:
+
+```json
+{
+  "max_bet": 2.0,
+  "min_ev": 0.10,
+  "min_volume": 500,
+  "scan_interval": 3600,
+  "telegram_bot_token": "your_token",
+  "telegram_chat_id": "your_chat_id"
+}
+```
+
+### 3. Start Trading
+
+```bash
+# Start the bot (runs in background)
+./start_bot_v3.sh
+
+# Stop the bot
+./stop_bot_v3.sh
+```
+
+That's it! The bot will continuously scan markets and trade automatically.
+
+---
+
 ## 🧠 Core Math: Gaussian Bucket Model
 
 ### Step 1 — True Probability from ECMWF
@@ -85,7 +145,7 @@ def calc_kelly(p, price):
 
 ## 🌀 Auto-Evolution Learning System
 
-This is a core strength of the Hermes Agent framework — the bot **learns from实战 and auto-tunes**:
+This is a core strength of the Hermes Agent framework — the bot **learns from trading and auto-tunes**:
 
 ```
 data/learning/
@@ -119,58 +179,6 @@ Telegram (Real-time Notifications)
 
 ---
 
-## ⚙️ Quick Start
-
-### Requirements
-- Python 3.13+
-- Polygon wallet + USDC.e
-- Polymarket CLOB approval
-- Polymarket API credentials
-
-### Installation
-```bash
-git clone https://github.com/nicolastinkl/hermes_weatherbot.git
-cd hermes_weatherbot
-python3.13 -m venv venv
-source venv/bin/activate
-pip install -r requirements.txt
-```
-
-### Configuration
-Create `.env`:
-```env
-PK=your_polygon_private_key
-WALLET=your_polygon_address
-SIG_TYPE=0
-```
-
-Edit `config.json`:
-```json
-{
-  "balance": 0,
-  "max_bet": 2.0,
-  "min_ev": 0.10,
-  "min_volume": 500,
-  "scan_interval": 3600,
-  "telegram_bot_token": "your_token",
-  "telegram_chat_id": "your_chat_id"
-}
-```
-
-### Run
-```bash
-# One-shot scan
-python bot_v3.py scan
-
-# Continuous trading loop
-python bot_v3.py run
-
-# Check status
-python bot_v3.py status
-```
-
----
-
 ## 🛡️ Risk Management
 
 | Parameter | Value | Purpose |