Hermes logo
Hermes Install Guide

Windows → WSL2 → Ubuntu → Hermes

Hermes Install Guide ที่สวย ใช้ง่าย และสอนต่อได้จริง

หน้านี้ทำมาสำหรับคนที่เริ่มจากศูนย์จริงๆ ไม่มี WSL ก็เริ่มได้ มี WSL อยู่แล้วก็ข้ามไปติดตั้ง Hermes ต่อได้ทันที ทุกคำสั่งถูกแยกตามบริบทให้ชัดว่าอะไรต้องรันใน PowerShell และอะไรต้องรันใน Ubuntu/WSL

เริ่มทีละขั้น ดูภาพรวมก่อน
wsl2 only ubuntu distro cli first git + curl coding + telegram
Before You Install

สิ่งที่ต้องรู้ก่อน

ยึดตาม docs ทางการของ Microsoft และ Hermes เพื่อให้สอนต่อได้โดยไม่เสี่ยงสอนผิด

Windows native ยังไม่รองรับ

Hermes ต้องรันใน Linux, macOS, หรือ WSL2 ดังนั้นบน Windows ให้ถือว่า WSL2 เป็นทางหลัก

Prerequisite ขั้นต่ำ

ใน Ubuntu ควรมี git และ curl ก่อนรัน installer

Installer จัด dependency ให้เยอะมาก

ตัวติดตั้งจะช่วยเรื่อง Python, uv, Node.js, ripgrep, ffmpeg และตัว command ของ Hermes ให้เอง

หลังติดตั้งต้อง reload shell

source ~/.bashrc จำเป็นถ้าจะใช้ hermes ต่อในหน้าต่างเดิมทันที

Install Tracker

ติ๊กตามความคืบหน้าได้เลย

สถานะถูกเก็บไว้ใน browser เครื่องนี้ ช่วยให้ใช้หน้านี้เป็นคู่มือเดินตามทีละขั้นได้จริง

Roadmap

ภาพรวมทั้งหน้า ก่อนเริ่มลงมือจริง

ถ้าปิ๊กอยากได้เว็บที่สอนแบบไล่เป็นบท หน้านี้จะพาเดินจากจุดเริ่มต้นไปจนใช้งาน Hermes ได้จริง โดยไม่ต้องสลับโหมดไปมา

A ปูพื้นและรู้ก่อน ทำความเข้าใจก่อนว่าอะไรต้องรันใน Windows และอะไรต้องรันใน Ubuntu B ติดตั้ง WSL2 เริ่มจากเครื่องที่ยังไม่มี WSL เลย พร้อม fallback ตอน install มีปัญหา C เตรียม Ubuntu เปิด distro ครั้งแรก ตั้ง user และลง prerequisite ที่จำเป็น D ติดตั้ง Hermes รัน installer, reload shell, เช็ก version และแก้จุดที่เจอบ่อย E ตั้งค่าและเริ่มใช้ เข้า wizard, เลือกค่าที่เหมาะกับสาย coding แล้วจบด้วย first run
Long Form Walkthrough

เดินทีละข้อแบบยาวๆ จน setup เสร็จ

อันนี้คือโครงใหม่ของหน้าเว็บ: ไม่ต้องเลือก flow แล้ว แต่จะเลื่อนลงตามลำดับจริงตั้งแต่ศูนย์จนจบ เหมาะกับใช้สอนและเหมาะกับคนที่อ่านตามทีละสเต็ป

A

Phase A: รู้ก่อนว่ากำลังติดตั้งอะไร

Hermes บน Windows ไม่ได้รันแบบ Windows native ตรงๆ แต่รันผ่าน WSL2 ดังนั้นให้จำกติกาเดียวก่อนเลย: ติดตั้ง WSL ใน PowerShell และติดตั้ง Hermes ใน Ubuntu

Step 0.1: แยกพื้นที่ทำงานให้ชัด

ถ้าสอนคนอื่นหรือแม้แต่สอนตัวเอง จุดที่ทำให้หลงง่ายที่สุดคือสลับ shell ผิดฝั่ง

Rule
  • PowerShell / Windows ใช้เฉพาะตอนติดตั้ง WSL, เช็ก distro, หรือสั่งคำสั่งระบบฝั่ง Windows
  • Ubuntu / WSL ใช้ตอนลง git, curl, Hermes และทุกคำสั่งใช้งานจริงของ Hermes
  • ถ้าพิมพ์ hermes แล้วไม่เจอทั้งที่เพิ่งติดตั้งเสร็จ ให้เช็กก่อนว่าตอนนี้อยู่ใน Ubuntu จริงไหม

Step 0.2: จำภาพรวมของ install path

ลำดับจริงมีแค่นี้ และถ้าจำ sequence นี้ได้ เว็บทั้งหน้าจะอ่านง่ายขึ้นมาก

Map
Install Map
Windows
  -> ติดตั้ง WSL2
  -> เปิด Ubuntu
  -> ลง git + curl
  -> รัน Hermes installer
  -> source ~/.bashrc
  -> hermes setup
  -> hermes doctor
  -> hermes
B

Phase B: ติดตั้ง WSL2 ถ้ายังไม่มี

ช่วงนี้ทำทั้งหมดใน PowerShell แบบ Admin เท่านั้น ถ้ามี WSL อยู่แล้วอ่านผ่านไป Phase C ได้เลย

Step 1: เปิด PowerShell แบบ Run as administrator

จำเป็นเพราะคำสั่งนี้จะเปิด feature ของ Windows และติดตั้ง Ubuntu ให้ด้วย หลัง install เสร็จต้อง restart เครื่อง 1 ครั้ง เลือกได้ว่าจะ restart เองหรือให้ script restart ให้

PowerShell (Admin)

Option A — Install เฉยๆ แล้ว restart เองทีหลัง

PowerShell (Admin)
wsl --install -d Ubuntu

Option B — Install เสร็จแล้ว auto-restart ใน 60 วินาที

PowerShell (Admin)
wsl --install -d Ubuntu; shutdown /r /t 60 /c "WSL ติดตั้งเสร็จแล้ว เครื่องจะ restart ใน 60 วินาที"
⚠ เตือนก่อนใช้ Option B เครื่องจะ restart อัตโนมัติ หลัง install เสร็จภายใน 60 วินาที — ปิดงานที่ยังไม่ได้เซฟก่อนรันคำสั่งนี้ ถ้าเปลี่ยนใจกลางทางพิมพ์ shutdown /a เพื่อยกเลิก restart ได้
ถ้าเครื่องนี้มี WSL บางส่วนอยู่แล้วจนคำสั่งไม่เดินตามคาด ให้ใช้ wsl --list --online ก่อน แล้วค่อยติดตั้ง distro โดยระบุชื่อชัดๆ

Step 2: ถ้าติดตั้งค้างที่ 0.0% ให้ใช้ web download

กรณีนี้เจอบ่อยพอสมควร โดยเฉพาะตอน Store หรือ image download ฝั่ง Windows มีปัญหา

Fallback
PowerShell (Admin)
wsl --install --web-download -d Ubuntu

Step 3: รีสตาร์ตเครื่อง แล้วเช็กว่าได้ WSL2 จริง

หลัง restart กลับมาเช็กเลยว่า Ubuntu ถูกติดตั้งแล้วและเวอร์ชันเป็น 2

Verify
PowerShell
wsl --list --verbose
  • ควรเห็นชื่อ distro เป็น Ubuntu
  • คอลัมน์ VERSION ควรเป็น 2
  • ถ้ายังเป็น 1 ให้สั่งอัปเกรดต่อทันที
PowerShell
wsl --set-version Ubuntu 2
C

Phase C: เปิด Ubuntu และเตรียมเครื่องให้พร้อม

จากตรงนี้เป็นต้นไปให้ถือว่าคุณย้ายเข้ามาอยู่ใน Linux แล้ว คำสั่ง Hermes ทุกตัวหลังจากนี้ควรรันใน Ubuntu

Step 4: เปิด Ubuntu ครั้งแรกและสร้าง Linux user

เปิดจาก Start Menu ได้เลย แล้วระบบจะถาม username/password สำหรับ environment ฝั่ง Linux ของเรา

Ubuntu / WSL
  • ตอนพิมพ์ password จะไม่เห็นตัวอักษรบนจอ ถือว่าปกติ
  • username/password นี้เป็นของ Linux ไม่จำเป็นต้องตรงกับบัญชี Windows
  • หลังจบขั้นนี้ prompt ควรเปลี่ยนมาเป็นหน้าตาแบบ Linux shell

Step 5: อัปเดต package list แล้วลง prerequisite

Hermes docs เน้น git เป็น prerequisite หลัก และใน flow จริงควรลง curl ด้วยเพราะ installer ใช้ curl โดยตรง

Ubuntu / WSL
Ubuntu / WSL
sudo apt update
sudo apt install -y git curl
git --version
curl --version
ถ้าสองคำสั่งท้ายแสดง version แปลว่าเครื่องพร้อมสำหรับติดตั้ง Hermes แล้ว
D

Phase D: ติดตั้ง Hermes จริง

ช่วงนี้คือหัวใจของหน้านี้ และเป็นช่วงที่หลายคนชอบพลาดเพราะรันผิด shell หรือไม่ได้ reload environment หลัง install

Step 6: รัน installer ของ Hermes

คำสั่งนี้ต้องรันใน Ubuntu/WSL และเป็นตัวเดียวที่ทำงานติดตั้ง dependency หลักให้แทบทั้งหมด

Ubuntu / WSL
Ubuntu / WSL
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
  • ตัวที่ถูกคือ curl ไม่ใช่ url
  • installer จะช่วยเรื่อง Python 3.11, uv, Node.js, ripgrep, ffmpeg และตัว command ของ Hermes
  • ให้รอจน installer จบเองก่อน อย่ารีบปิดหน้าต่าง Ubuntu กลางคัน

Step 7: reload shell เพื่อให้ PATH ใหม่มีผล

นี่คือขั้นที่ทำให้หลายคนงงว่าทำไมติดตั้งเสร็จแล้วแต่พิมพ์ hermes ไม่ได้

Ubuntu / WSL
Ubuntu / WSL
source ~/.bashrc
hermes --version
  • source ~/.bashrc คือการ reload config ของ shell ปัจจุบันทันที
  • ถ้าไม่ทำ อาจเจอ hermes: command not found ทั้งที่ install สำเร็จแล้ว
  • ถ้าปิด Ubuntu แล้วเปิดใหม่ก็ได้ผลคล้ายกัน แต่ source จะเร็วกว่า
E

Phase E: เข้า wizard แล้วทำให้ใช้งานได้จริง

จุดนี้ถือว่าเครื่องพร้อมแล้ว เหลือแค่เลือก provider, model, tools และยืนยันว่าระบบใช้งานจริงได้

Step 8: เปิด setup wizard

ถ้าจะสอนคนอื่น หน้านี้คือจุดที่ควรอธิบายทีละช่อง เพราะคนใหม่มักไม่รู้ว่าค่าไหนมีผลอะไรบ้าง

Ubuntu / WSL
Ubuntu / WSL
hermes setup
  • เลือก provider ที่มี API key พร้อมอยู่แล้ว จะตั้งได้เร็วที่สุด
  • เลือก model ที่มี context อย่างน้อย 64K
  • ถ้าจะเน้น coding เป็นหลัก ให้ดู preset แนะนำใน section ถัดไป

Step 9: เช็กว่าระบบพร้อม แล้วเปิดใช้งานจริง

หลัง setup เสร็จให้ทดสอบทั้งสุขภาพระบบและตัวแชตใน terminal ไปเลยรอบเดียว

Ubuntu / WSL
Ubuntu / WSL
hermes doctor
hermes
ถ้าขึ้น doctor ผ่าน และเข้า chat ได้ แปลว่าหน้า install นี้พาปิดงานได้ครบแล้ว

Step 10: เก็บชุดคำสั่งสั้นไว้สอนต่อ

อันนี้เหมาะมากเวลาปิ๊กจะเอาไปบอกใครอีกคนแบบรวบรัด แต่ยังถูกบริบทครบ

Cheat Sheet
Windows + Ubuntu
# PowerShell (Admin)
wsl --install -d Ubuntu

# Ubuntu / WSL
sudo apt update
sudo apt install -y git curl
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
hermes doctor
hermes
Recommended Setup

ค่าที่แนะนำตอนอยู่ใน wizard

ส่วนนี้เป็น preset แนะนำถ้าเป้าหมายหลักคือใช้ Hermes ใน CLI เพื่อ coding และ workflow ส่วนตัว

ค่าแนะนำสำหรับสาย coding

Setting ค่าแนะนำ เหตุผล
Max iterations 150 บาลานซ์ดีสำหรับ vibe coding และงานหลายขั้นตอน
Tool progress mode all เห็นว่า agent กำลังใช้อะไร โดยไม่ noisy เกิน verbose
Compression threshold 0.7 เก็บ context ได้นานพอสำหรับงาน coding แต่ไม่บวมเร็วเกิน
Search provider Skip หรือ Tavily Skip ถ้ายังไม่ใช้ web research, Tavily ถ้าจะค้นเว็บตั้งแต่วันแรก

Tools ที่ควรเปิดใน CLI

  • Terminal & Processes สำหรับรันคำสั่งและตรวจระบบ
  • File Operations สำหรับอ่าน เขียน ค้นหา patch ไฟล์
  • Code Execution สำหรับงานที่ต้องรันโค้ดจริง
  • Skills, Task Planning, Memory, Session Search
  • Clarifying Questions และ Task Delegation ถ้าจะใช้ subagents
ถ้าจะใช้แค่ CLI ตอนแรก ยังไม่ต้องเปิด Telegram ก็ได้ ค่อยไปตั้ง hermes gateway setup ทีหลัง
What Next

หลังติดตั้งเสร็จควรทำอะไรต่อ

หน้านี้เน้นให้จบที่ setup แต่ถ้าจะใช้ต่อจริง คำสั่งชุดนี้จะช่วยให้เริ่มได้เร็วมาก

CLI workflow

Ubuntu / WSL
hermes
hermes doctor
hermes model
hermes tools

ถ้าจะคุยผ่าน Telegram ทีหลัง

Ubuntu / WSL
hermes gateway setup
hermes gateway status
ให้ตั้ง Telegram หลังจาก CLI ใช้งานได้ก่อน จะ debug ง่ายกว่าเยอะ
Troubleshooting

ปัญหาที่เจอบ่อย และวิธีแก้เร็ว

ส่วนนี้ไว้ใช้ตอนสอนคนอื่น เพราะส่วนใหญ่จะสะดุดไม่กี่จุดซ้ำๆ เดิม

hermes: command not found

ส่วนใหญ่เกิดจาก shell ยังไม่ reload หลังติดตั้ง

Ubuntu / WSL
source ~/.bashrc
hermes --version

curl: command not found หรือ git: command not found

เครื่อง Ubuntu ยังไม่มี prerequisite ขั้นต่ำ

Ubuntu / WSL
sudo apt update
sudo apt install -y git curl

wsl --install ขึ้น help text แทนที่จะติดตั้ง

มักเกิดตอนเครื่องมี WSL บางส่วนอยู่แล้ว หรือใช้รูปแบบคำสั่งไม่ตรงสถานะปัจจุบัน

PowerShell
wsl --list --online
wsl --install -d Ubuntu

เผลอรันคำสั่ง Hermes ใน PowerShell

ให้จำง่ายๆ ว่า Hermes ต้องอยู่ใน Ubuntu/WSL ถ้า prompt ไม่ใช่ Linux shell ให้หยุดแล้วสลับหน้าต่างก่อน

กฎจำง่าย: ติดตั้ง WSL ใน PowerShell, แต่ติดตั้ง Hermes ใน Ubuntu
Official Sources

อ้างอิงทางการที่ใช้ทำหน้านี้

เผื่อจะส่งต่อให้คนอื่นหรือย้อนเช็กว่า flow นี้อิงจากที่ไหนบ้าง

Microsoft WSL Install

คำสั่งหลักสำหรับติดตั้ง WSL2, วิธีเช็กเวอร์ชัน, และ fallback ตอน install มีปัญหา

learn.microsoft.com/en-us/windows/wsl/install

Hermes Install Guide ref Hermes Agent v0.9.0 MIT · 2026
← → nav Space pause
01/09
—