Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [i18n] Thai Translation: Getting Started [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#14621•Fetched 2026-04-24 06:15:50
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
nanobronanobro
Participants
nanobronanobro
Timeline (top)
labeled ×2cross-referenced ×1

Error Message

  • Hermes ตอบโดยไม่มี error การย้อนกลับอาจทำให้ config ไม่เข้ากันหากมี options ใหม่ถูกเพิ่ม รัน hermes config check หลังย้อนกลับและลบ options ที่ไม่รู้จักจาก config.yaml หากเจอ error
  • คำสั่งติดตั้งที่แน่นอนและ output error แบบเต็ม

Code Example

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

---

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

---

source ~/.bashrc   # หรือ: source ~/.zshrc
hermes             # เริ่มคุยเลย!

---

hermes model          # เลือก LLM provider และ model
hermes tools          # ตั้งค่า tools ที่เปิดใช้งาน
hermes gateway setup  # ตั้งค่าแพลตฟอร์ม messaging
hermes config set     # ตั้งค่า config แต่ละรายการ
hermes setup          # หรือรัน setup wizard แบบเต็มเพื่อตั้งค่าทุกอย่างพร้อมกัน

---

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

---

source ~/.bashrc   # หรือ source ~/.zshrc

---

hermes model

---

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

---

hermes            # classic CLI
hermes --tui      # modern TUI (แนะนำ)

---

สรุป repo นี้เป็น 5 ข้อ และบอกว่า main entrypoint คืออะไร

---

ตรวจสอบ directory ปัจจุบันและบอกว่าไฟล์ไหนดูเหมือนไฟล์หลักของโปรเจกต์

---

ช่วยตั้งค่า GitHub PR workflow ที่เรียบร้อยสำหรับ codebase นี้

---

hermes --continue    # กลับไปเซสชันล่าสุด
hermes -c            # แบบย่อ

---

❯ พื้นที่ดิสก์เหลือเท่าไหร่? แสดง 5 directory ใหญ่ที่สุด

---

hermes gateway setup    # ตั้งค่าแพลตฟอร์มแบบ interactive

---

hermes config set terminal.backend docker    # การแยกด้วย Docker
hermes config set terminal.backend ssh       # Remote server

---

pip install "hermes-agent[voice]"
# รวม faster-whisper สำหรับ speech-to-text แบบ local ฟรี

---

hermes skills search kubernetes
hermes skills install openai/skills/k8s

---

# เพิ่มใน ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

---

pip install -e '.[acp]'
hermes acp

---

hermes update

---

$ hermes update
Updating Hermes Agent...
📥 Pulling latest code...
Already up to date.  (หรือ: Updating abc1234..def5678)
📦 Updating dependencies...
✅ Dependencies updated
🔍 Checking for new config options...
✅ Config is up to date  (หรือ: Found 2 new options - running migration...)
🔄 Restarting gateway service...
✅ Gateway restarted
✅ Hermes Agent updated successfully!

---

tail -f ~/.hermes/logs/update.log

---

hermes version

---

/update

---

cd /path/to/hermes-agent
export VIRTUAL_ENV="$(pwd)/venv"

# ดึงโค้ดและ submodules ล่าสุด
git pull origin main
git submodule update --init --recursive

# ติดตั้งใหม่ (รับ dependencies ใหม่)
uv pip install -e ".[all]"
uv pip install -e "./tinker-atropos"

# ตรวจสอบ config options ใหม่
hermes config check
hermes config migrate   # เพิ่ม options ที่ขาดแบบ interactive

---

cd /path/to/hermes-agent

# ดูเวอร์ชันล่าสุด
git log --oneline -10

# ย้อนกลับไป commit เฉพาะ
git checkout <commit-hash>
git submodule update --init --recursive
uv pip install -e ".[all]"

# รีสตาร์ท gateway ถ้ากำลังรันอยู่
hermes gateway restart

---

git checkout v0.6.0
git submodule update --init --recursive
uv pip install -e ".[all]"

---

# อัปเดต flake input
nix flake update hermes-agent

# หรือ rebuild ด้วยเวอร์ชันล่าสุด
nix profile upgrade hermes-agent

---

nix profile rollback

---

hermes uninstall

---

rm -f ~/.local/bin/hermes
rm -rf /path/to/hermes-agent
rm -rf ~/.hermes            # เลือกได้ - เก็บไว้หากต้องการติดตั้งใหม่

---

hermes gateway stop
# Linux: systemctl --user disable hermes-gateway
# macOS: launchctl remove ai.hermes.gateway

---

python -m pip install -e '.[termux]' -c constraints-termux.txt

---

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

---

pkg update
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

---

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

---

git submodule update --init --recursive

---

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel

---

python -m pip install -e '.[termux]' -c constraints-termux.txt

---

python -m pip install -e '.' -c constraints-termux.txt

---

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

---

hermes version
hermes doctor

---

hermes

---

hermes model

---

hermes setup

---

pkg install nodejs-lts
npm install

---

python -m pip install -e '.[termux]' -c constraints-termux.txt

---

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel
python -m pip install -e '.[termux]' -c constraints-termux.txt

---

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install -e '.[termux]' -c constraints-termux.txt

---

pkg install ripgrep nodejs

---

pkg install clang rust make pkg-config libffi openssl

---

python -m pip install -e '.[termux]' -c constraints-termux.txt
RAW_BUFFERClick to expand / collapse

📄 index.md

slug: / sidebar_position: 0 title: "Hermes Agent Documentation" description: "The self-improving AI agent built by Nous Research. A built-in learning loop that creates skills from experience, improves them during use, and remembers across sessions." hide_table_of_contents: true displayed_sidebar: docs

Hermes Agent

AI agent ที่พัฒนาขึ้นเองอย่างต่อเนื่อง สร้างโดย Nous Research Agent เดียวที่มีระบบ learning loop ในตัว - สร้าง skills จากประสบการณ์, ปรับปรุงตนเองระหว่างใช้งาน, เตือนตัวเองให้บันทึกความรู้ และสร้างแบบจำลองความเข้าใจเกี่ยวกับคุณให้ลึกซึ้งขึ้นทุกครั้งที่ใช้งานข้ามเซสชัน

<div style={{display: 'flex', gap: '1rem', marginBottom: '2rem', flexWrap: 'wrap'}}> <a href="/docs/getting-started/installation" style={{display: 'inline-block', padding: '0.6rem 1.2rem', backgroundColor: '#FFD700', color: '#07070d', borderRadius: '8px', fontWeight: 600, textDecoration: 'none'}}>เริ่มต้นใช้งาน →</a> <a href="https://github.com/NousResearch/hermes-agent" style={{display: 'inline-block', padding: '0.6rem 1.2rem', border: '1px solid rgba(255,215,0,0.2)', borderRadius: '8px', textDecoration: 'none'}}>ดูบน GitHub</a> </div>

Hermes Agent คืออะไร?

ไม่ใช่ coding copilot ที่ผูกติดอยู่กับ IDE หรือ chatbot wrapper ที่หุ้ม API เดียว แต่เป็น autonomous agent ที่ยิ่งใช้ยิ่งเก่งขึ้น วางไว้ที่ไหนก็ได้ - VPS ราคา $5, GPU cluster หรือ serverless infrastructure (Daytona, Modal) ที่แทบไม่มีค่าใช้จ่ายเมื่อไม่ได้ใช้งาน คุยกับมันผ่าน Telegram ขณะที่มันทำงานบน cloud VM ที่คุณไม่ต้อง SSH เข้าไปเองเลย มันไม่ผูกติดกับ laptop ของคุณ

ลิงก์ด่วน

🚀 การติดตั้งติดตั้งใน 60 วินาที บน Linux, macOS หรือ WSL2
📖 บทแนะนำเริ่มใช้งานบทสนทนาแรกและฟีเจอร์สำคัญที่ควรลอง
🗺️ เส้นทางการเรียนรู้หาเอกสารที่เหมาะกับระดับประสบการณ์ของคุณ
⚙️ การตั้งค่าไฟล์ config, providers, models และตัวเลือกต่างๆ
💬 Messaging Gatewayตั้งค่า Telegram, Discord, Slack หรือ WhatsApp
🔧 Tools & Toolsets47 built-in tools และวิธีตั้งค่า
🧠 ระบบ MemoryPersistent memory ที่เติบโตข้ามเซสชัน
📚 ระบบ SkillsProcedural memory ที่ agent สร้างและนำกลับมาใช้ใหม่
🔌 MCP Integrationเชื่อมต่อ MCP servers, กรอง tools และขยายความสามารถอย่างปลอดภัย
🧭 ใช้ MCP กับ Hermesรูปแบบการตั้งค่า MCP แบบปฏิบัติ, ตัวอย่าง และบทแนะนำ
🎙️ Voice Modeการสนทนาด้วยเสียงแบบ real-time ใน CLI, Telegram, Discord และ Discord VC
🗣️ ใช้ Voice Mode กับ Hermesการตั้งค่าและรูปแบบการใช้งาน voice แบบปฏิบัติจริง
🎭 บุคลิก & SOUL.mdกำหนดเสียงเริ่มต้นของ Hermes ด้วย SOUL.md ระดับโกลบอล
📄 Context Filesไฟล์ context ของโปรเจกต์ที่กำหนดรูปแบบทุกบทสนทนา
🔒 ความปลอดภัยการอนุมัติคำสั่ง, การกำหนดสิทธิ์, การแยก container
💡 เคล็ดลับ & Best Practicesเทคนิคดีๆ เพื่อให้ใช้ Hermes อย่างเต็มประสิทธิภาพ
🏗️ สถาปัตยกรรมมันทำงานอย่างไรภายใต้ประทุน
❓ FAQ & การแก้ปัญหาคำถามที่พบบ่อยและวิธีแก้ไข

ฟีเจอร์สำคัญ

  • วงจรการเรียนรู้แบบปิด - Memory ที่ agent คัดสรรด้วยการเตือนเป็นระยะ, การสร้าง skills อัตโนมัติ, การปรับปรุง skills ระหว่างใช้งาน, การเรียกค้นข้ามเซสชันด้วย FTS5 พร้อม LLM summarization และการสร้างแบบจำลองผู้ใช้แบบ dialectic ผ่าน Honcho
  • รันได้ทุกที่ ไม่ใช่แค่บน laptop - 6 terminal backends: local, Docker, SSH, Daytona, Singularity, Modal - Daytona และ Modal มี serverless persistence - environment ของคุณจะ hibernate เมื่อไม่ใช้ ค่าใช้จ่ายแทบไม่มี
  • อยู่ได้ทุกแพลตฟอร์มที่คุณใช้ - CLI, Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email, SMS, DingTalk, Feishu, WeCom, BlueBubbles, Home Assistant - 15+ แพลตฟอร์มจาก gateway เดียว
  • สร้างโดยทีมฝึกโมเดล - พัฒนาโดย Nous Research ห้องปฏิบัติการเบื้องหลัง Hermes, Nomos และ Psyche ทำงานร่วมกับ Nous Portal, OpenRouter, OpenAI หรือ endpoint ใดๆ
  • ระบบ automation ตามกำหนดเวลา - Built-in cron พร้อมการส่งผลลัพธ์ไปยังแพลตฟอร์มใดๆ
  • มอบหมายงานและทำขนาน - สร้าง subagent แยกเพื่อทำงานขนานกัน Tool Calling แบบ programmatic ผ่าน execute_code ลดขั้นตอน pipeline หลายขั้นเป็นคำสั่ง inference เดียว
  • Skills ตามมาตรฐานเปิด - ใช้ร่วมกับ agentskills.io ได้ Skills พกพา แชร์ได้ และสนับสนุนโดยชุมชนผ่าน Skills Hub
  • ควบคุมเว็บเต็มรูปแบบ - ค้นหา, ดึงข้อมูล, เรียกดู, วิเคราะห์ภาพ, สร้างภาพ, TTS
  • รองรับ MCP - เชื่อมต่อ MCP server ใดๆ เพื่อขยายความสามารถด้าน tools
  • พร้อมสำหรับงานวิจัย - Batch processing, trajectory export, RL training กับ Atropos สร้างโดย Nous Research - ห้องปฏิบัติการเบื้องหลังโมเดล Hermes, Nomos และ Psyche

📄 getting-started/installation.md

sidebar_position: 2 title: "Installation" description: "Install Hermes Agent on Linux, macOS, WSL2, or Android via Termux"

การติดตั้ง

ติดตั้ง Hermes Agent แล้วใช้งานได้ในเวลาไม่ถึงสองนาทีด้วย one-line installer

ติดตั้งอย่างรวดเร็ว

Linux / macOS / WSL2

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Android / Termux

Hermes มี installer path สำหรับ Termux ด้วย:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Installer จะตรวจจับ Termux อัตโนมัติและเปลี่ยนไปใช้ flow สำหรับ Android ที่ผ่านการทดสอบแล้ว:

  • ใช้ Termux pkg สำหรับ system dependencies (git, python, nodejs, ripgrep, ffmpeg, build tools)
  • สร้าง virtualenv ด้วย python -m venv
  • export ANDROID_API_LEVEL อัตโนมัติสำหรับ Android wheel builds
  • ติดตั้ง .[termux] extra ที่คัดสรรแล้วด้วย pip
  • ข้าม browser / WhatsApp bootstrap ที่ยังไม่ได้ทดสอบโดย default

หากต้องการขั้นตอนแบบละเอียด ดู คู่มือ Termux แบบเฉพาะ

:::warning Windows Native Windows ไม่รองรับ กรุณาติดตั้ง WSL2 และรัน Hermes Agent จากในนั้น คำสั่งติดตั้งด้านบนใช้ได้ใน WSL2 :::

Installer ทำอะไรบ้าง

Installer จัดการทุกอย่างอัตโนมัติ - ทุก dependencies (Python, Node.js, ripgrep, ffmpeg), repo clone, virtual environment, ตั้งค่าคำสั่ง hermes ระดับระบบ และ config LLM provider เสร็จแล้วพร้อมคุย

หลังติดตั้งเสร็จ

Reload shell แล้วเริ่มคุย:

source ~/.bashrc   # หรือ: source ~/.zshrc
hermes             # เริ่มคุยเลย!

หากต้องการตั้งค่าใหม่ภายหลัง ใช้คำสั่งเฉพาะ:

hermes model          # เลือก LLM provider และ model
hermes tools          # ตั้งค่า tools ที่เปิดใช้งาน
hermes gateway setup  # ตั้งค่าแพลตฟอร์ม messaging
hermes config set     # ตั้งค่า config แต่ละรายการ
hermes setup          # หรือรัน setup wizard แบบเต็มเพื่อตั้งค่าทุกอย่างพร้อมกัน

สิ่งที่ต้องมีก่อน

สิ่งเดียวที่ต้องมีคือ Git จะจัดการทุกอย่างอัตโนมัติ:

  • uv (fast Python package manager)
  • Python 3.11 (ผ่าน uv ไม่ต้องใช้ sudo)
  • Node.js v22 (สำหรับ browser automation และ WhatsApp bridge)
  • ripgrep (ค้นหาไฟล์อย่างรวดเร็ว)
  • ffmpeg (แปลงรูปแบบเสียงสำหรับ TTS)

:::info คุณ ไม่ต้อง ติดตั้ง Python, Node.js, ripgrep หรือ ffmpeg เอง Installer จะตรวจจับสิ่งที่ขาดและติดตั้งให้ แค่ตรวจสอบว่า git มีอยู่ (git --version) :::

:::tip สำหรับผู้ใช้ Nix หากคุณใช้ Nix (บน NixOS, macOS หรือ Linux) มีเส้นทางตั้งค่าเฉพาะด้วย Nix flake, declarative NixOS module และ container mode แบบเลือกได้ ดู Nix & NixOS Setup guide :::

การติดตั้งแบบ Manual / Developer

หากต้องการ clone repo และติดตั้งจาก source - เพื่อมีส่วนร่วม, รันจาก branch เฉพาะ หรือควบคุม virtual environment อย่างเต็มที่ - ดูหัวข้อ Development Setup ใน Contributing guide

การแก้ปัญหา

ปัญหาวิธีแก้
hermes: command not foundReload shell (source ~/.bashrc) หรือตรวจสอบ PATH
API key not setรัน hermes model เพื่อตั้งค่า provider หรือ hermes config set OPENROUTER_API_KEY your_key
Config หายหลังอัปเดตรัน hermes config check แล้ว hermes config migrate

สำหรับการวินิจฉัยเพิ่มเติม รัน hermes doctor - มันจะบอกว่าขาดอะไรและจะแก้อย่างไร

📄 getting-started/quickstart.md

sidebar_position: 1 title: "Quickstart" description: "Your first conversation with Hermes Agent - from install to chatting in under 5 minutes"

เริ่มใช้งานอย่างรวดเร็ว

คู่มือนี้พาคุณจากศูนย์ไปสู่ Hermes setup ที่ใช้งานได้จริง ติดตั้ง, เลือก provider, ทดสอบการคุยที่ใช้ได้ และรู้ว่าจะทำอย่างไรเมื่อมีปัญหา

คู่มือนี้สำหรับใคร

  • มือใหม่และต้องการเส้นทางที่สั้นที่สุดไปสู่ setup ที่ใช้ได้
  • กำลังเปลี่ยน provider และไม่อยากเสียเวลากับ config ผิดๆ
  • ตั้งค่า Hermes สำหรับทีม, bot หรือ workflow ที่ต้องทำงานตลอดเวลา
  • เบื่อกับ "ติดตั้งแล้ว แต่ยังทำอะไรไม่ได้"

เส้นทางที่เร็วที่สุด

เลือกแถวที่ตรงกับเป้าหมายของคุณ:

เป้าหมายทำอย่างนี้ก่อนแล้วทำอย่างนี้
อยากให้ Hermes ทำงานบนเครื่องผมhermes setupลองคุยจริงและตรวจว่าตอบได้
รู้ provider อยู่แล้วhermes modelบันทึก config แล้วเริ่มคุย
อยากได้ bot หรือ setup ทำงานตลอดhermes gateway setup หลังจาก CLI ใช้ได้เชื่อมต่อ Telegram, Discord, Slack หรือแพลตฟอร์มอื่น
อยากใช้โมเดล local หรือ self-hostedhermes model → custom endpointตรวจสอบ endpoint, ชื่อ model และ context length
อยากใช้ multi-provider fallbackhermes model ก่อนเพิ่ม routing และ fallback หลังจาก base chat ใช้ได้แล้ว

กฎเบื้องต้น: ถ้า Hermes ยังคุยกันธรรมดาไม่ได้ อย่าเพิ่มฟีเจอร์เพิ่มเติม ทำให้บทสนทนาเดียวใช้ได้ก่อน แล้วค่อยเพิ่ม gateway, cron, skills, voice หรือ routing

1. ติดตั้ง Hermes Agent

รัน one-line installer:

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

:::tip Android / Termux หากติดตั้งบนมือถือ ดู คู่มือ Termux สำหรับเส้นทาง manual ที่ผ่านการทดสอบ, extras ที่รองรับ และข้อจำกัดเฉพาะ Android ปัจจุบัน :::

:::tip ผู้ใช้ Windows ติดตั้ง WSL2 ก่อน แล้วรันคำสั่งด้านบนใน WSL2 terminal :::

หลังเสร็จแล้ว reload shell:

source ~/.bashrc   # หรือ source ~/.zshrc

สำหรับตัวเลือกการติดตั้งแบบละเอียด สิ่งที่ต้องมีก่อน และการแก้ปัญหา ดู คู่มือการติดตั้ง

2. เลือก Provider

ขั้นตอนที่สำคัญที่สุด ใช้ hermes model เพื่อเลือกแบบ interactive:

hermes model

ค่า default ที่ดี:

สถานการณ์แนะนำ
น้อยปัญหาสุดNous Portal หรือ OpenRouter
มี auth ของ Claude หรือ Codex อยู่แล้วAnthropic หรือ OpenAI Codex
อยาก inference แบบ local/ส่วนตัวOllama หรือ custom OpenAI-compatible endpoint ใดๆ
อยากใช้ multi-provider routingOpenRouter
มี GPU server เองvLLM, SGLang, LiteLLM หรือ OpenAI-compatible endpoint ใดๆ

สำหรับผู้ใช้ใหม่ส่วนใหญ่: เลือก provider และใช้ค่า default ไปก่อน ยกเว้นคุณรู้ว่าต้องเปลี่ยน รายการ provider ทั้งหมดพร้อม env vars และขั้นตอน setup อยู่ที่หน้า Providers

:::caution Context ขั้นต่ำ: 64K tokens Hermes Agent ต้องการโมเดลที่มี context อย่างน้อย 64,000 tokens โมเดลที่มี context window เล็กกว่านี้จะไม่สามารถรักษา working memory เพียงพอสำหรับ multi-step tool-calling workflows และจะถูกปฏิเสธตอนเริ่มต้น โมเดล hosted ส่วนใหญ่ (Claude, GPT, Gemini, Qwen, DeepSeek) ผ่านเกณฑ์นี้ได้ง่าย หากรันโมเดล local ให้ตั้งค่า context size อย่างน้อย 64K (เช่น --ctx-size 65536 สำหรับ llama.cpp หรือ -c 65536 สำหรับ Ollama) :::

:::tip คุณสลับ provider ได้ทุกเมื่อด้วย hermes model - ไม่มีการผูกขาด สำหรับรายการ provider ทั้งหมด ดู AI Providers :::

การจัดเก็บ settings

Hermes แยก secrets ออกจาก config ปกติ:

  • Secrets และ tokens → ~/.hermes/.env
  • Settings ที่ไม่ใช่ secret → ~/.hermes/config.yaml

วิธีง่ายที่สุดคือผ่าน CLI:

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

ค่าจะถูกเขียนไปยังไฟล์ที่ถูกต้องอัตโนมัติ

3. รันบทสนทนาแรก

hermes            # classic CLI
hermes --tui      # modern TUI (แนะนำ)

คุณจะเห็น welcome banner พร้อม model, tools ที่ใช้ได้ และ skills ใช้ prompt ที่เจาะจงและตรวจสอบง่าย:

:::tip เลือก interface Hermes มาพร้อม terminal interface สองแบบ: classic prompt_toolkit CLI และ TUI ใหม่กว่าที่มี modal overlays, เลือกด้วยเมาส์ และ non-blocking input ทั้งสองใช้ sessions, slash commands และ config เดียวกัน - ลองทั้ง hermes และ hermes --tui :::

สรุป repo นี้เป็น 5 ข้อ และบอกว่า main entrypoint คืออะไร
ตรวจสอบ directory ปัจจุบันและบอกว่าไฟล์ไหนดูเหมือนไฟล์หลักของโปรเจกต์
ช่วยตั้งค่า GitHub PR workflow ที่เรียบร้อยสำหรับ codebase นี้

สัญญาณว่าสำเร็จ:

  • Banner แสดง model/provider ที่เลือก
  • Hermes ตอบโดยไม่มี error
  • สามารถใช้ tool ได้ถ้าต้องการ (terminal, อ่านไฟล์, ค้นหาเว็บ)
  • บทสนทนาดำเนินต่อได้ปกติมากกว่าหนึ่งรอบ

ถ้าได้ขนาดนี้ คุณผ่านส่วนที่ยากที่สุดไปแล้ว

4. ตรวจสอบว่า Sessions ทำงาน

ก่อนไปต่อ ตรวจว่า resume ใช้ได้:

hermes --continue    # กลับไปเซสชันล่าสุด
hermes -c            # แบบย่อ

น่าจะพาคุณกลับไปเซสชันเดิม ถ้าไม่ได้ ตรวจว่าคุณอยู่ใน profile เดียวกันและเซสชันถูกบันทึกจริง เรื่องนี้สำคัญตอนคุณใช้หลาย setup หรือหลายเครื่อง

5. ลองฟีเจอร์สำคัญ

ใช้ terminal

❯ พื้นที่ดิสก์เหลือเท่าไหร่? แสดง 5 directory ใหญ่ที่สุด

Agent จะรันคำสั่ง terminal แทนคุณและแสดงผลลัพธ์

Slash commands

พิมพ์ / เพื่อดู autocomplete ของคำสั่งทั้งหมด:

คำสั่งทำอะไร
/helpแสดงคำสั่งทั้งหมด
/toolsแสดง tools ที่ใช้ได้
/modelสลับโมเดลแบบ interactive
/personality pirateลองบุคลิกสนุกๆ
/saveบันทึกบทสนทนา

พิมพ์หลายบรรทัด

กด Alt+Enter หรือ Ctrl+J เพื่อขึ้นบรรทัดใหม่ เหมาะสำหรับวางโค้ดหรือเขียน prompt ยาวๆ

ขัดจังหวะ agent

ถ้า agent ใช้เวลานานเกินไป พิมพ์ข้อความใหม่แล้วกด Enter - มันจะขัดจังหวะงานปัจจุบันแล้วเปลี่ยนไปทำตามคำสั่งใหม่ Ctrl+C ก็ใช้ได้

6. เพิ่มขั้นต่อไป

ทำหลังจาก base chat ใช้ได้แล้วเท่านั้น เลือกตามที่ต้องการ:

Bot หรือ assistant แชร์กัน

hermes gateway setup    # ตั้งค่าแพลตฟอร์มแบบ interactive

เชื่อมต่อ Telegram, Discord, Slack, WhatsApp, Signal, Email หรือ Home Assistant

Automation และ tools

  • hermes tools - ปรับการเข้าถึง tools ตามแพลตฟอร์ม
  • hermes skills - ค้นหาและติดตั้ง workflows ที่ใช้ซ้ำได้
  • Cron - ใช้หลัง bot หรือ CLI setup มั่นคงแล้วเท่านั้น

Terminal แบบ sandboxed

เพื่อความปลอดภัย รัน agent ใน Docker container หรือบน remote server:

hermes config set terminal.backend docker    # การแยกด้วย Docker
hermes config set terminal.backend ssh       # Remote server

Voice mode

pip install "hermes-agent[voice]"
# รวม faster-whisper สำหรับ speech-to-text แบบ local ฟรี

แล้วใน CLI: /voice on กด Ctrl+B เพื่ออัดเสียง ดู Voice Mode

Skills

hermes skills search kubernetes
hermes skills install openai/skills/k8s

หรือใช้ /skills ในเซสชันคุย

MCP servers

# เพิ่มใน ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Editor integration (ACP)

pip install -e '.[acp]'
hermes acp

ดู ACP Editor Integration

ปัญหาที่พบบ่อย

อาการสาเหตุน่าจะเป็นวิธีแก้
Hermes เปิดได้แต่ตอบว่างเปล่าหรือผิดเพี้ยนProvider auth หรือเลือก model ผิดรัน hermes model ใหม่และยืนยัน provider, model และ auth
Custom endpoint "ใช้ได้" แต่ได้ขยะbase URL, ชื่อ model ผิด หรือไม่ได้ OpenAI-compatibleทดสอบ endpoint ด้วย client อื่นก่อน
Gateway เริ่มได้แต่ใครก็คุยด้วยไม่ได้Bot token, allowlist หรือ platform setup ไม่ครบรัน hermes gateway setup ใหม่และเช็ค hermes gateway status
hermes --continue หาเซสชันเก่าไม่เจอเปลี่ยน profile หรือเซสชันไม่ถูกบันทึกเช็ค hermes sessions list และยืนยันว่าอยู่ใน profile ที่ถูกต้อง
Model ไม่พร้อมใช้หรือ fallback ผิดปกติProvider routing หรือ fallback settings ก้าวร้าวเกินไปปิด routing จนกว่า base provider จะมั่นคง
hermes doctor แจ้งปัญหา configค่า config ขาดหรือเก่าแก้ config แล้วทดสอบคุยธรรมดาก่อนเพิ่มฟีเจอร์

เครื่องมือกู้คืน

เมื่อรู้สึกว่ามีอะไรไม่ถูกต้อง ใช้ตามลำดับนี้:

  1. hermes doctor
  2. hermes model
  3. hermes setup
  4. hermes sessions list
  5. hermes --continue
  6. hermes gateway status

ลำดับนี้พาคุณจาก "รู้สึกไม่ดี" กลับมาสู่สถานะที่รู้จักได้เร็ว

อ้างอิงด่วน

คำสั่งคำอธิบาย
hermesเริ่มคุย
hermes modelเลือก LLM provider และ model
hermes toolsตั้งค่า tools ที่เปิดใช้ตามแพลตฟอร์ม
hermes setupSetup wizard แบบเต็ม (ตั้งค่าทุกอย่างพร้อมกัน)
hermes doctorวินิจฉัยปัญหา
hermes updateอัปเดตเป็นเวอร์ชันล่าสุด
hermes gatewayเริ่ม messaging gateway
hermes --continueกลับไปเซสชันล่าสุด

ขั้นต่อไป

📄 getting-started/learning-path.md

sidebar_position: 3 title: 'Learning Path' description: 'Choose your learning path through the Hermes Agent documentation based on your experience level and goals.'

เส้นทางการเรียนรู้

Hermes Agent ทำอะไรได้เยอะ - CLI assistant, Telegram/Discord bot, task automation, RL training และอื่นๆ หน้านี้ช่วยคุณหาจุดเริ่มต้นและว่าควรอ่านอะไรตามระดับประสบการณ์และเป้าหมายของคุณ

:::tip เริ่มที่นี่ หากยังไม่ได้ติดตั้ง Hermes Agent เริ่มจาก คู่มือการติดตั้ง แล้วทำตาม Quickstart ทุกอย่างด้านล่างถือว่าคุณมี installation ที่ใช้งานได้ :::

ใช้หน้านี้อย่างไร

ตามระดับประสบการณ์

ระดับเป้าหมายแนะนำอ่านเวลาโดยประมาณ
มือใหม่เริ่มใช้งานได้, คุยพื้นฐาน, ใช้ built-in toolsInstallation → Quickstart → CLI Usage → Configuration~1 ชั่วโมง
กลางตั้งค่า messaging bots, ใช้ฟีเจอร์ขั้นสูง เช่น memory, cron jobs, skillsSessions → Messaging → Tools → Skills → Memory → Cron~2-3 ชั่วโมง
ขั้นสูงสร้าง custom tools, สร้าง skills, ฝึกโมเดลด้วย RL, มีส่วนร่วมในโปรเจกต์Architecture → Adding Tools → Creating Skills → RL Training → Contributing~4-6 ชั่วโมง

ตาม Use Case

เลือกสถานการณ์ที่ตรงกับสิ่งที่คุณอยากทำ แต่ละอันจะลิงก์ไปยังเอกสารที่เกี่ยวข้องตามลำดับที่ควรอ่าน

"อยากได้ CLI coding assistant"

ใช้ Hermes Agent เป็น terminal assistant แบบ interactive สำหรับเขียน, review และรันโค้ด

  1. Installation
  2. Quickstart
  3. CLI Usage
  4. Code Execution
  5. Context Files
  6. Tips & Tricks

:::tip ส่งไฟล์เข้าบทสนทนาได้โดยตรงด้วย context files Hermes Agent อ่าน, แก้ไขและรันโค้ดในโปรเจกต์ของคุณได้ :::

"อยากได้ Telegram/Discord bot"

Deploy Hermes Agent เป็น bot บนแพลตฟอร์ม messaging ที่คุณชอบ

  1. Installation
  2. Configuration
  3. Messaging Overview
  4. Telegram Setup
  5. Discord Setup
  6. Voice Mode
  7. Use Voice Mode with Hermes
  8. Security

ตัวอย่างโปรเจกต์แบบเต็ม:

"อยาก automate tasks"

ตั้งเวลางาน recurring, รัน batch jobs หรือเชื่อม agent actions เข้าด้วยกัน

  1. Quickstart
  2. Cron Scheduling
  3. Batch Processing
  4. Delegation
  5. Hooks

:::tip Cron jobs ให้ Hermes Agent รันงานตามกำหนดเวลา - สรุปรายวัน, ตรวจสอบเป็นรอบ, รายงานอัตโนมัติ - โดยไม่ต้องอยู่หน้าจอ :::

"อยากสร้าง custom tools/skills"

ขยาย Hermes Agent ด้วย tools ของคุณเองและ skill packages ที่ใช้ซ้ำได้

  1. Tools Overview
  2. Skills Overview
  3. MCP (Model Context Protocol)
  4. Architecture
  5. Adding Tools
  6. Creating Skills

:::tip Tools คือฟังก์ชันแยกที่ agent เรียกใช้ได้ Skills คือชุดของ tools, prompts และ configuration รวมกัน เริ่มจาก tools ก่อน แล้วค่อยเติบโตไปเป็น skills :::

"อยากฝึกโมเดล"

ใช้ reinforcement learning เพื่อ fine-tune พฤติกรรมโมเดลด้วย RL training pipeline ในตัวของ Hermes Agent

  1. Quickstart
  2. Configuration
  3. RL Training
  4. Provider Routing
  5. Architecture

:::tip RL training ทำงานได้ดีที่สุดเมื่อคุณเข้าใจพื้นฐานว่า Hermes Agent จัดการบทสนทนาและ tool calls อย่างไร ถ้าใหม่อยู่ ทำตามเส้นทางมือใหม่ก่อน :::

"อยากใช้เป็น Python library"

เชื่อม Hermes Agent เข้ากับแอป Python ของคุณแบบ programmatic

  1. Installation
  2. Quickstart
  3. Python Library Guide
  4. Architecture
  5. Tools
  6. Sessions

ฟีเจอร์สำคัญเผยๆ

ไม่แน่ใจว่ามีอะไรให้ใช้? นี่คือไดเรกทอรีฟีเจอร์หลัก:

ฟีเจอร์ทำอะไรลิงก์
ToolsBuilt-in tools ที่ agent เรียกได้ (file I/O, ค้นหา, shell ฯลฯ)Tools
SkillsPlugin packages แบบติดตั้งได้ที่เพิ่มความสามารถใหม่Skills
MemoryPersistent memory ข้ามเซสชันMemory
Context Filesส่งไฟล์และ directories เข้าบทสนทนาContext Files
MCPเชื่อมต่อ external tool servers ผ่าน Model Context ProtocolMCP
Cronตั้งเวลางาน agent แบบ recurringCron
Delegationสร้าง sub-agents ทำงานขนานDelegation
Code Executionรัน Python scripts ที่เรียก Hermes tools แบบ programmaticCode Execution
Browserเรียกดูและดึงข้อมูลเว็บBrowser
HooksEvent-driven callbacks และ middlewareHooks
Batch Processingประมวลผลหลายอินพุตแบบกลุ่มBatch Processing
RL TrainingFine-tune โมเดลด้วย reinforcement learningRL Training
Provider Routingส่ง request ข้ามหลาย LLM providersProvider Routing

อ่านอะไรต่อ

ตามจุดที่คุณอยู่ตอนนี้:

  • เพิ่งติดตั้งเสร็จ? → ไป Quickstart เพื่อรันบทสนทนาแรก
  • ทำ Quickstart แล้ว? → อ่าน CLI Usage และ Configuration เพื่อปรับแต่ง setup
  • คุ้นเคยกับพื้นฐานแล้ว? → สำรวจ Tools, Skills และ Memory เพื่อปลดล็อกพลังเต็มของ agent
  • ตั้งค่าสำหรับทีม? → อ่าน Security และ Sessions เพื่อเข้าใจการควบคุมการเข้าถึงและการจัดการบทสนทนา
  • พร้อมสร้าง? → เข้า Developer Guide เพื่อเข้าใจ internals และเริ่มมีส่วนร่วม
  • อยากดูตัวอย่างจริง? → ดูส่วน Guides สำหรับโปรเจกต์จริงและเคล็ดลับ

:::tip คุณไม่ต้องอ่านทุกอย่าง เลือกเส้นทางที่ตรงกับเป้าหมาย ทำตามลิงก์ตามลำดับ แล้วคุณจะทำงานได้เร็ว กลับมาหน้านี้เสมอได้เพื่อหาขั้นต่อไป :::

📄 getting-started/updating.md

sidebar_position: 3 title: "Updating & Uninstalling" description: "How to update Hermes Agent to the latest version or uninstall it"

การอัปเดตและถอนการติดตั้ง

การอัปเดต

อัปเดตเป็นเวอร์ชันล่าสุดด้วยคำสั่งเดียว:

hermes update

คำสั่งนี้ดึงโค้ดล่าสุด, อัปเดต dependencies และเตือนคุณตั้งค่า options ใหม่ที่เพิ่มตั้งแต่อัปเดตครั้งก่อน

:::tip hermes update ตรวจจับ configuration options ใหม่อัตโนมัติและเตือนให้เพิ่ม หากข้ามไป รัน hermes config check เพื่อดู options ที่ขาด แล้ว hermes config migrate เพื่อเพิ่มแบบ interactive :::

อัปเดตเกิดอะไรขึ้นบ้าง

เมื่อรัน hermes update จะเกิดขั้นตอนต่อไปนี้:

  1. Git pull - ดึงโค้ดล่าสุดจาก branch main และอัปเดต submodules
  2. Dependency install - รัน uv pip install -e ".[all]" เพื่อติดตั้ง dependencies ใหม่หรือที่เปลี่ยนแปลง
  3. Config migration - ตรวจจับ config options ใหม่ที่เพิ่มตั้งแต่เวอร์ชันของคุณและเตือนให้ตั้งค่า
  4. Gateway auto-restart - หาก gateway service กำลังทำงาน (systemd บน Linux, launchd บน macOS) จะ รีสตาร์ทอัตโนมัติ หลังอัปเดตเสร็จเพื่อให้โค้ดใหม่มีผลทันที

ตัวอย่าง output:

$ hermes update
Updating Hermes Agent...
📥 Pulling latest code...
Already up to date.  (หรือ: Updating abc1234..def5678)
📦 Updating dependencies...
✅ Dependencies updated
🔍 Checking for new config options...
✅ Config is up to date  (หรือ: Found 2 new options - running migration...)
🔄 Restarting gateway service...
✅ Gateway restarted
✅ Hermes Agent updated successfully!

การตรวจสอบหลังอัปเดต

hermes update จัดการเส้นทางหลัก แต่การตรวจสอบเพิ่มเติมจะยืนยันว่าทุกอย่างเรียบร้อย:

  1. git status --short - หาก working tree มีการเปลี่ยนแปลงไม่คาดฝัน ให้ตรวจสอบก่อนดำเนินการต่อ
  2. hermes doctor - ตรวจสอบ config, dependencies และ service health
  3. hermes --version - ยืนยันว่าเวอร์ชันอัปเดตแล้ว
  4. หากใช้ gateway: hermes gateway status
  5. หาก doctor แจ้ง npm audit: รัน npm audit fix ใน directory ที่ระบุ

:::warning Working tree มีการเปลี่ยนแปลงหลังอัปเดต หาก git status --short แสดงการเปลี่ยนแปลงที่ไม่คาดฝันหลัง hermes update ให้หยุดและตรวจสอบก่อนดำเนินการ มักหมายถึงการแก้ไข local ถูกนำไปทับกับโค้ดที่อัปเดต หรือขั้นตอน dependency เปลี่ยน lockfiles :::

หาก terminal หลุดระหว่างอัปเดต

hermes update ป้องกันการขาดการเชื่อมต่อ terminal โดยไม่ตั้งใจ:

  • การอัปเดตไม่สนใจ SIGHUP ดังนั้นการปิด SSH session หรือหน้าต่าง terminal จะไม่ฆ่ามันระหว่างติดตั้ง pip และ git child processes รับการป้องกันนี้ไปด้วย ดังนั้น Python environment จะไม่ถูกทิ้งครึ่งๆ จากการขาดการเชื่อมต่อ
  • Output ทั้งหมดถูกส่งไปที่ ~/.hermes/logs/update.log ขณะอัปเดต หาก terminal หาย เชื่อมต่อใหม่แล้วตรวจสอบ log ว่าอัปเดตเสร็จหรือไม่ และ gateway restart สำเร็จหรือไม่:
tail -f ~/.hermes/logs/update.log
  • Ctrl-C (SIGINT) และ system shutdown (SIGTERM) ยังทำงาน - นั่นคือการยกเลิกโดยเจตนา ไม่ใช่อุบัติเหตุ

คุณไม่ต้องห่อ hermes update ด้วย screen หรือ tmux เพื่อป้องกันการหลุด terminal อีกต่อไป

ตรวจสอบเวอร์ชันปัจจุบัน

hermes version

เปรียบเทียบกับ release ล่าสุดที่ หน้า GitHub releases

อัปเดตจากแพลตฟอร์ม Messaging

คุณสามารถอัปเดตโดยตรงจาก Telegram, Discord, Slack หรือ WhatsApp โดยส่ง:

/update

คำสั่งนี้ดึงโค้ดล่าสุด, อัปเดต dependencies และรีสตาร์ท gateway Bot จะออฟไลน์สั้นๆ ระหว่างรีสตาร์ท (ประมาณ 5-15 วินาที) แล้วกลับมาทำงาน

อัปเดตแบบ Manual

หากติดตั้งแบบ manual (ไม่ใช่ quick installer):

cd /path/to/hermes-agent
export VIRTUAL_ENV="$(pwd)/venv"

# ดึงโค้ดและ submodules ล่าสุด
git pull origin main
git submodule update --init --recursive

# ติดตั้งใหม่ (รับ dependencies ใหม่)
uv pip install -e ".[all]"
uv pip install -e "./tinker-atropos"

# ตรวจสอบ config options ใหม่
hermes config check
hermes config migrate   # เพิ่ม options ที่ขาดแบบ interactive

คำแนะนำการย้อนกลับ

หากอัปเดตทำให้เกิดปัญหา คุณสามารถย้อนกลับไปเวอร์ชันก่อนหน้า:

cd /path/to/hermes-agent

# ดูเวอร์ชันล่าสุด
git log --oneline -10

# ย้อนกลับไป commit เฉพาะ
git checkout <commit-hash>
git submodule update --init --recursive
uv pip install -e ".[all]"

# รีสตาร์ท gateway ถ้ากำลังรันอยู่
hermes gateway restart

ย้อนกลับไป release tag เฉพาะ:

git checkout v0.6.0
git submodule update --init --recursive
uv pip install -e ".[all]"

:::warning การย้อนกลับอาจทำให้ config ไม่เข้ากันหากมี options ใหม่ถูกเพิ่ม รัน hermes config check หลังย้อนกลับและลบ options ที่ไม่รู้จักจาก config.yaml หากเจอ error :::

หมายเหตุสำหรับผู้ใช้ Nix

หากติดตั้งผ่าน Nix flake การอัปเดตจัดการผ่าน Nix package manager:

# อัปเดต flake input
nix flake update hermes-agent

# หรือ rebuild ด้วยเวอร์ชันล่าสุด
nix profile upgrade hermes-agent

การติดตั้ง Nix เป็นแบบ immutable - การย้อนกลับจัดการโดยระบบ generation ของ Nix:

nix profile rollback

ดู Nix Setup สำหรับรายละเอียดเพิ่มเติม

การถอนการติดตั้ง

hermes uninstall

Uninstaller ให้ตัวเลือกเก็บไฟล์ config (~/.hermes/) ไว้สำหรับติดตั้งใหม่ในอนาคต

ถอนการติดตั้งแบบ Manual

rm -f ~/.local/bin/hermes
rm -rf /path/to/hermes-agent
rm -rf ~/.hermes            # เลือกได้ - เก็บไว้หากต้องการติดตั้งใหม่

:::info หากติดตั้ง gateway เป็น system service ให้หยุดและปิดก่อน:

hermes gateway stop
# Linux: systemctl --user disable hermes-gateway
# macOS: launchctl remove ai.hermes.gateway

:::

📄 getting-started/termux.md

sidebar_position: 3 title: "Android / Termux" description: "Run Hermes Agent directly on an Android phone with Termux"

Hermes บน Android ด้วย Termux

นี่คือเส้นทางที่ผ่านการทดสอบสำหรับรัน Hermes Agent บนมือถือ Android ผ่าน Termux

ให้คุณ CLI บนมือถือที่ใช้งานได้ พร้อม core extras ที่ทดสอบแล้วว่าติดตั้งได้บน Android

อะไรที่รองรับในเส้นทางที่ทดสอบ?

Termux bundle ที่ทดสอบแล้วติดตั้ง:

  • Hermes CLI
  • รองรับ cron
  • รองรับ PTY/background terminal
  • รองรับ Telegram gateway (manual / best-effort background runs)
  • รองรับ MCP
  • รองรับ Honcho memory
  • รองรับ ACP

กำหนดเป็นคำสั่ง:

python -m pip install -e '.[termux]' -c constraints-termux.txt

อะไรที่ยังไม่อยู่ในเส้นทางที่ทดสอบ?

บางฟีเจอร์ยังต้องการ dependencies แบบ desktop/server ที่ไม่มีสำหรับ Android หรือยังไม่ได้ทดสอบบนมือถือ:

  • .[all] ไม่รองรับบน Android ในขณะนี้
  • extra voice ถูกบล็อกโดย faster-whisper -> ctranslate2 ซึ่ง ctranslate2 ไม่มี Android wheels
  • automatic browser / Playwright bootstrap ถูกข้ามใน Termux installer
  • การแยก terminal ด้วย Docker ไม่มีใน Termux
  • Android อาจ suspend Termux background jobs ได้ ดังนั้น gateway persistence เป็นแบบ best-effort มากกว่า managed service ปกติ

แต่ก็ไม่ได้หมายความว่า Hermes จะใช้ไม่ได้เป็น CLI agent บนมือถือ - แค่หมายความว่าการติดตั้งบนมือถือจะแคบกว่า desktop/server อย่างตั้งใจ

ตัวเลือก 1: One-line installer

Hermes มี installer path สำหรับ Termux:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

บน Termux installer จะอัตโนมัติ:

  • ใช้ pkg สำหรับ system packages
  • สร้าง venv ด้วย python -m venv
  • ติดตั้ง .[termux] ด้วย pip
  • ลิงก์ hermes เข้า $PREFIX/bin เพื่อให้อยู่ใน Termux PATH
  • ข้าม browser / WhatsApp bootstrap ที่ยังไม่ทดสอบ

หากต้องการคำสั่งแบบชัดเจนหรือต้อง debug การติดตั้งที่ล้มเหลว ใช้เส้นทาง manual ด้านล่าง

ตัวเลือก 2: ติดตั้ง Manual (แบบชัดเจนทุกขั้นตอน)

1. อัปเดต Termux และติดตั้ง system packages

pkg update
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

ทำไมต้องมีเหล่านี้?

  • python - runtime + venv support
  • git - clone/update repo
  • clang, rust, make, pkg-config, libffi, openssl - จำเป็นสำหรับ build Python dependencies บน Android
  • nodejs - Node runtime เลือกได้สำหรับการทดลองนอกเหนือจาก core path ที่ทดสอบ
  • ripgrep - ค้นหาไฟล์อย่างรวดเร็ว
  • ffmpeg - แปลง media / TTS

2. Clone Hermes

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

หาก clone ไปแล้วโดยไม่มี submodules:

git submodule update --init --recursive

3. สร้าง virtual environment

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel

ANDROID_API_LEVEL สำคัญสำหรับ Rust / maturin-based packages เช่น jiter

4. ติดตั้ง Termux bundle ที่ทดสอบแล้ว

python -m pip install -e '.[termux]' -c constraints-termux.txt

หากต้องการแค่ core agent ขั้นต่ำ ก็ใช้ได้:

python -m pip install -e '.' -c constraints-termux.txt

5. ใส่ hermes ใน Termux PATH

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

$PREFIX/bin อยู่ใน PATH ของ Termux อยู่แล้ว ดังนั้นคำสั่ง hermes จะใช้ได้ข้าม shell ใหม่โดยไม่ต้อง activate venv ทุกครั้ง

6. ตรวจสอบการติดตั้ง

hermes version
hermes doctor

7. เริ่ม Hermes

hermes

การตั้งค่าเพิ่มเติมแนะนำ

ตั้งค่า model

hermes model

หรือตั้งค่า keys โดยตรงใน ~/.hermes/.env

รัน setup wizard แบบ interactive ใหม่ภายหลัง

hermes setup

ติดตั้ง Node dependencies เพิ่มเติมแบบ manual

เส้นทาง Termux ที่ทดสอบข้าม Node/browser bootstrap โดยเจตนา หากอยากทดลอง browser tooling ภายหลัง:

pkg install nodejs-lts
npm install

Browser tool จะรวม Termux directories (/data/data/com.termux/files/usr/bin) ใน PATH search อัตโนมัติ ดังนั้น agent-browser และ npx จะถูกค้นพบโดยไม่ต้องตั้งค่า PATH เพิ่มเติม

ให้ถือว่า browser / WhatsApp tooling บน Android เป็นแบบทดลองจนกว่าจะมีเอกสารอื่นระบุ

การแก้ปัญหา

No solution found ตอนติดตั้ง .[all]

ใช้ Termux bundle ที่ทดสอบแล้วแทน:

python -m pip install -e '.[termux]' -c constraints-termux.txt

ตัวบล็อกคือ extra voice:

  • voice ดึง faster-whisper
  • faster-whisper ขึ้นกับ ctranslate2
  • ctranslate2 ไม่มี Android wheels

uv pip install ล้มเหลวบน Android

ใช้เส้นทาง Termux กับ stdlib venv + pip แทน:

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel
python -m pip install -e '.[termux]' -c constraints-termux.txt

jiter / maturin แจ้งเกี่ยวกับ ANDROID_API_LEVEL

ตั้งค่า API level ก่อนติดตั้ง:

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install -e '.[termux]' -c constraints-termux.txt

hermes doctor บอกว่า ripgrep หรือ Node ขาด

ติดตั้งด้วย Termux packages:

pkg install ripgrep nodejs

Build ล้มเหลวระหว่างติดตั้ง Python packages

ตรวจสอบว่า build toolchain ติดตั้งแล้ว:

pkg install clang rust make pkg-config libffi openssl

แล้วลองใหม่:

python -m pip install -e '.[termux]' -c constraints-termux.txt

ข้อจำกัดที่ทราบบนมือถือ

  • Docker backend ไม่มี
  • การถอดเสียงแบบ local ผ่าน faster-whisper ไม่มีในเส้นทางที่ทดสอบ
  • การตั้งค่า browser automation ถูกข้ามโดย installer โดยเจตนา
  • บาง optional extras อาจทำงานได้ แต่มีเพียง .[termux] เท่านั้นที่ถูกบันทึกเป็น Android bundle ที่ทดสอบ

หากพบปัญหาเฉพาะ Android ใหม่ กรุณาเปิด GitHub issue พร้อม:

  • เวอร์ชัน Android ของคุณ
  • termux-info
  • python --version
  • hermes doctor
  • คำสั่งติดตั้งที่แน่นอนและ output error แบบเต็ม

extent analysis

TL;DR

The most likely fix for the issue is to follow the installation guide for Hermes Agent on Linux, macOS, or WSL2, and ensure that all dependencies, including Git, Python, Node.js, ripgrep, and ffmpeg, are installed and up-to-date.

Guidance

  1. Check the installation: Verify that Hermes Agent is installed correctly by running hermes --version and checking the output.
  2. Update dependencies: Ensure that all dependencies, including Git, Python, Node.js, ripgrep, and ffmpeg, are up-to-date by running pkg update and pkg install -y git python nodejs ripgrep ffmpeg on Termux.
  3. Run the setup wizard: Run hermes setup to configure Hermes Agent and set up the necessary environment variables.
  4. Check the configuration: Verify that the configuration is correct by running hermes config check and checking the output.
  5. Test the agent: Test Hermes Agent by running hermes and checking that it responds correctly to commands.

Example

To install Hermes Agent on Termux, run the following command:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Then, update the dependencies and run the setup wizard:

pkg update
pkg install -y git python nodejs ripgrep ffmpeg
hermes setup

Notes

  • Make sure to follow the installation guide carefully and ensure that all dependencies are installed and up-to-date.
  • If you encounter any issues during installation, check the output and error messages for clues on how to resolve the issue.
  • Hermes Agent has a comprehensive documentation and community support, so don't hesitate to reach out if you need help.

Recommendation

Apply the workaround by following the installation guide and updating dependencies to ensure a smooth installation and configuration of Hermes Agent.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#installation#autograd error#model save/load#batch processing

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING