LostHex-Skills/INSTALL.md

📦 INSTALL — ติดตั้ง LostHex แบบละเอียด

อ่าน 5 นาที ทำตามทีละขั้น — ติดตรงไหนมีวิธีแก้ให้ทุกจุด
5 minutes here saves an hour of debugging. Follow step by step.

📚 สารบัญ / Contents

0) เช็คก่อนว่ามีอะไรแล้ว
1) วางสกิลเข้า Hermes
2) HexStrike 150 Tools — มือยิง
3) CyberStrike — สมองเสริม (ข้ามได้)
4) Tools พื้นฐานเพิ่มเติม
5) ตรวจว่าพร้อม — Verify
6) อัปเดต / Troubleshooting

0) (Windows) ลง WSL2 + Kali ก่อน — 5 นาทีจบ / WSL2 First

ข้ามได้ถ้าใช้ Linux/macOS อยู่แล้ว — ขั้นนี้สำหรับ Windows เท่านั้น
Skip if you're on Linux/macOS — Windows only.

# PowerShell — รันทีละบรรทัด (ไม่ต้อง admin ถ้า wsl --update ผ่าน)
wsl --version          # ถ้าไม่มี -> wsl --update
wsl --update           # อัปเดต kernel (ครั้งแรกอาจต้องรอ 1-2 นาที)
wsl --install -d kali-linux --no-launch
# ถ้าติดตั้งแล้วขึ้น "already installed" คือมีแล้ว ข้ามไปได้เลย

# เข้า Kali ครั้งแรก / Enter Kali first time
wsl -d kali-linux

ใน Kali (prompt เปลี่ยนเป็น root@...):

sudo apt update
sudo apt install -y nmap ffuf gobuster nuclei sqlmap hydra john hashcat \
  whatweb amass subfinder httpx dnsx impacket-scripts bloodhound smbclient
exit
# กลับมา Windows — WSL2 พร้อมแล้ว / Back to Windows — WSL2 ready
wsl --list --verbose  # ต้องเห็น kali-linux Running/Stopped

ทำไมต้องทำก่อน? เพราะ HexStrike บน Windows ได้ ~90 tools — บน Kali/WSL2 ได้ 150 ครบ (hydra, john, wpscan, responder, aircrack, tshark, ghidra … มีแค่บน Linux)
ถ้าไม่ลง WSL2 จะยังใช้งานได้แบบ degraded — แต่ถ้าลงจะได้ครบ

0b) เช็คก่อนว่ามีอะไรแล้ว / Pre-check

เปิด terminal แล้วรัน — ถ้าขึ้นเวอร์ชันคือมีแล้ว ข้ามไปได้เลย

node -v        # ต้องขึ้น v22.x  — ถ้าไม่มี ดูข้างล่าง
python -V      # ต้องขึ้น Python 3.12.x
git --version  # ต้องขึ้น git version ...
hermes --version  # ต้องขึ้น Hermes ...

ถ้ายังไม่มี / If missing

ตัว / Tool	Windows	macOS	Linux / WSL2 Kali
Node 22	nodejs.org หรือ `winget install OpenJS.NodeJS`	`brew install node@22`	`curl -fsSL https://deb.nodesource.com/setup_22.x \| sudo -E bash - && sudo apt install -y nodejs`
Python 3.12	python.org หรือ `winget install Python.Python.3.12`	`brew install python@3.12`	`sudo apt install -y python3 python3-venv python3-pip`
Git	git-scm.com	`brew install git`	`sudo apt install -y git`
Hermes	hermes-agent.nousresearch.com/docs	—	—

💡 Windows ทริค: ถ้าลง Node/Python แบบ portable (zip) อย่าลืมเพิ่มเข้า PATH — ไม่งั้น node -v จะหาไม่เจอ

1) วางสกิลเข้า Hermes / Other Harnesses

ใช้ harness อื่น? ดู AGENTS.md หรือ python ./scripts/harness.py --install <harness> Hermes = /LostHex, Cursor/Claude Code/OpenCode ก็ได้ — หรืออ่าน SKILL.md ตรงๆ แบบ generic

1) Hermes (native) / Install Skills

0) เอา repo มา / Get the repo

repo อยู่บน Cloudflare Workers git server (GitHub เดิมโดนระงับ) — เลือกทางใดทางหนึ่ง

# ทางที่ 1 — git clone (anonymous read)
git clone https://losthex-git.lostsky777.workers.dev/losthex-skills.git
cd LostHex-Skills

# ทางที่ 2 — ไม่มี git: โหลด zip จากเว็ปแล้วแตก
# https://losthex-skills.pages.dev/LostHex-Skills.zip

# ทางที่ 3 — เน็ตถูกบล็อก: bundle สำรอง (มีทุก commit)
git clone LostHex-Skills-latest.bundle LostHex-Skills

วิธีที่ง่ายที่สุด — ก็อปปี้ตรงๆ / Easiest — direct copy

# Windows / Linux / macOS / WSL2 — ใช้ installer (คัดสกิล + references/ ให้ครบ)
python ./scripts/install_skills.py

# หรือก็อปเองแบบ manual (ระวัง: ไม่ได้ copy references/ ให้)
# PowerShell: Copy-Item -Recurse skills\losthex* $env:LOCALAPPDATA\hermes\skills\
# Linux:      cp -r skills/losthex* ~/.local/share/hermes/skills/

ตรวจว่าเข้าแล้ว / Verify

รีสตาร์ท Hermes 1 ครั้ง / Restart Hermes once
พิมพ์ / ในแชท — ต้องเห็น /LostHex, /LostHex-HACK, /LostHex-METHOD … ขึ้นมา 26 อัน
ถ้าไม่ขึ้น → ลองเช็ค path:

# ดูว่าสกิลอยู่ถูกที่ไหม
ls $LOCALAPPDATA/hermes/skills/ | grep losthex   # Windows
ls ~/.local/share/hermes/skills/ | grep losthex  # Linux

ถ้ายังไม่ขึ้น — ลอง hermes skills list | grep losthex ดูว่า Hermes เจอไหม

2) HexStrike 150 Tools — มือยิง

ทำไมต้องลง? /LostHex-HACK ออโต้จะสั่ง nmap, ffuf, nuclei, sqlmap ฯลฯ ผ่าน HexStrike — ถ้าไม่ลงจะ fallback เป็น curl มือ ช้าลง ~40%

2.1 Clone + สร้าง venv

# โคลน
git clone https://github.com/0x4m4/hexstrike-ai.git
cd hexstrike-ai

# สร้าง venv + ลง deps
python -m venv .venv

# Windows
.venv\Scripts\pip install -r requirements.txt
# Linux / Kali
.venv/bin/pip install -r requirements.txt

2.2 รัน Server

# Windows — ใส่ -E ด้วย! (สำคัญมาก ดู pitfall ข้างล่าง)
.venv\Scripts\python.exe -E hexstrike_server.py
# -> ต้องขึ้น Flask on 127.0.0.1:8888

# Linux / Kali
.venv/bin/python -E hexstrike_server.py

⚠️ Pitfall ยอดฮิต: ถ้ารันแล้วเจอ mcp_types import error — ลืมใส่ -E
Hermes ตั้ง PYTHONPATH ทับ venv ทำให้ mcp import เพี้ยน — ใส่ -E เสมอ

ปล่อย server รันค้างไว้ — เปิดอีก terminal ทำขั้นต่อไป / Keep it running, open another terminal.

2.3 ต่อ MCP เข้า Hermes

# Windows — ใส่ python แบบ absolute path + -E หน้า args เสมอ
hermes mcp add hexstrike-ai \
  --command "C:/path/to/hexstrike-ai/.venv/Scripts/python.exe" \
  --connect-timeout 180 \
  --args -E C:/path/to/hexstrike-ai/hexstrike_mcp.py --server http://127.0.0.1:8888

# Linux
hermes mcp add hexstrike-ai \
  --command "/path/to/hexstrike-ai/.venv/bin/python" \
  --connect-timeout 180 \
  --args -E /path/to/hexstrike-ai/hexstrike_mcp.py --server http://127.0.0.1:8888

เมื่อถาม Enable all 150 tools? → ตอบ Y

2.4 ตรวจ / Verify

hermes mcp test hexstrike-ai
# ต้องขึ้น ✓ Connected  +  ✓ Tools discovered: 150

ขึ้นอะไร / Output	แปลว่า / Means	แก้ยังไง / Fix
`✓ Connected, 150 tools`	พร้อมแล้ว / Ready	ลุยได้เลย
`timeout`	server ยังไม่รัน หรือ cold start ช้า	เช็คว่า `hexstrike_server.py` รันอยู่ + ใส่ `--connect-timeout 180`
`mcp_types error`	ลืม `-E`	ใส่ `-E` หน้า python
`127 tools`	ขาด binary บางตัว	ไม่เป็นไร ใช้ได้ — หรือลงเพิ่มบน Kali/WSL2 จะได้ 150

3) CyberStrike — สมองเสริม (ข้ามได้) / Optional

ไม่บังคับ! Hermes ที่คุยอยู่นี่คือสมองหลักแล้ว
CyberStrike เป็นแค่สมองที่ 2 — จะรัน cyberstrike CLI เพียวๆ ถึงค่อยต้องมี LLM key
Optional! Hermes IS the main brain. Only need a key if you run cyberstrike CLI standalone.

# ลงตัวหลัก
npm install -g @cyberstrike-io/cyberstrike

# ⚠️ ต้องลง platform binary แยก — ตัวหลักเป็นแค่ launcher!
# Windows
npm install -g @cyberstrike-io/cyberstrike-windows-x64
# Linux / Kali
npm install -g @cyberstrike-io/cyberstrike-linux-x64

# ตรวจ
cyberstrike --version        # ต้องขึ้น 1.1.16+
# ถ้า git-bash เพี้ยน
cyberstrike.CMD --version

ถ้าจะรัน CLI เพียวๆ ค่อยตั้ง key / Only if you run CLI standalone

cyberstrike auth login
# หรือ
export ANTHROPIC_API_KEY=sk-ant-...
# หรือ
export OPENAI_API_KEY=sk-...

ถ้าใช้ผ่าน /LostHex-HACK ใน Hermes — ข้ามขั้นนี้ไปได้เลย / If you use /LostHex-HACK in Hermes, skip this.

4) Tools พื้นฐานเพิ่มเติม / Extra Tools

บางโหมดเรียก binary ตรง — ถ้า HexStrike ไม่มีตัวนั้นในเครื่อง จะ fallback เป็น manual
ดูตารางเต็ม → TOOLS.md

Kali / WSL2 — ลงครบสุด (แนะนำ):

sudo apt update && sudo apt install -y \
  nmap ffuf gobuster nuclei sqlmap hydra john hashcat \
  whatweb masscan amass subfinder httpx dnsx \
  impacket-scripts bloodhound smbclient enum4linux-ng

go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest

Windows — ใช้ HexStrike dispatch เป็นหลัก
บางตัวไม่มีบน Windows (hydra, john, wpscan, responder …) — ใช้ Kali/WSL2 จะได้ครบ

5) ตรวจว่าพร้อม / Verify

# ปกติ — ต้อง PASS ถึงจะรัน full mode ได้
python ./scripts/verify.py

# ถ้าลง tools ไม่ได้ — degraded ก็พอ
python ./scripts/verify.py --degraded

# ดูละเอียด
python ./scripts/verify.py --verbose

# runtime gate — เช็ค HexStrike ที่รันอยู่จริง (ฝังมากับทุกสกิล)
python scripts/gate.py

ต้องขึ้น:

[ok] Hermes CLI
[ok] hermes skills contain losthex
[ok] hexstrike mcp: connected
[ok] cyberstrike (optional)
RESULT: PASS — พร้อมลุย /LostHex-HACK

ถ้ามี [FAIL] → กลับไปแก้ขั้นนั้นก่อน อย่าฝืนรัน

6) อัปเดต / Update & Troubleshooting

อัปเดต / Update

git pull
cd hexstrike-ai && git pull && .venv/Scripts/pip install -r requirements.txt
npm update -g @cyberstrike-io/cyberstrike @cyberstrike-io/cyberstrike-windows-x64

ปัญหายอดฮิต / Common Issues

อาการ / Symptom	สาเหตุ / Cause	แก้ / Fix
`/LostHex-*` ไม่ขึ้น	สกิลยังไม่ copy / Hermes ยังไม่ restart	กลับข้อ 1, restart Hermes
`mcp_types` error	`PYTHONPATH` ทับ venv	ใส่ `-E` หน้า `python`
`hexstrike timeout`	cold start >30s	`--connect-timeout 180`
tool ค้าง 300s แล้วขึ้น `MCP call timed out after 300.0s`	HexStrike cap ทุก command ที่ 300s และ tool ไม่จบ (เช่น `subfinder -all` default `-max-time 10m`)	ตั้ง `HEXSTRIKE_COMMAND_TIMEOUT=240` ใน `hexstrike.bat` (server จะคืนผลก่อน client หมดเวลา) + ส่ง `{"timeout": 45}` ต่อ call ใน JSON body
`/health` ตอบช้า ~20s	tool detection ไล่ probe ~150 binary ทุกครั้ง	patch cache แล้ว (`HEXSTRIKE_HEALTH_TTL=300`, refresh ด้วย `/health?refresh=1`)
ยิงคำสั่งเดิมแล้วได้ผลเดิมทันที	HexStrike cache ตาม command string (TTL 1 ชม.)	เปลี่ยน argument หรือ `POST /api/cache/clear`
gate ค้าง/ช้า	เรียก `/health` แทน process health	ใช้ `python scripts/gate.py` (เรียก `/api/process/health-check` ก่อน)
`cyberstrike: failed to install platform`	npm block optional dep	ลง `cyberstrike-windows-x64` แยก
`cyberstrike: command not found` (git-bash)	shim ต้องใช้ sed	เรียก `cyberstrike.CMD` ตรงๆ
`verify.py` timeout	hermes CLI ค้าง	รัน `python ./scripts/verify.py --degraded` แทน

ติดตรงไหน เปิด issue ได้เลย — หรือพิมพ์ /LostHex ถามในแชทก็ได้ 💬

14,977 bytes · view raw