Hermes Workshop

# 1. SSH client ada dan bisa dipakai
ssh -V

# 2. Masuk ke VPS yang diberikan trainer
ssh <user>@<host-vps>

# 3. Di dalam VPS — Hermes hidup?
hermes version

# TODO(trainer): ganti dengan prosedur akses yang sebenarnya.
# Belum ditentukan dan TIDAK boleh dikarang:
#   - host / IP VPS
#   - pola nama user (per peserta atau shared)
#   - cara distribusi kunci SSH
# Sumber: docs/hermes-training-blueprint.md §7 item 3

ssh <user>@<host-vps>

hermes version
hermes doctor

ssh <user>@<host-vps>

hermes version      # nomor versi tercetak
hermes doctor       # laporan environment
hermes              # masuk ke sesi chat

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# VPS headless tanpa browser: lewati langkah Playwright
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser

# setelah instalasi
source ~/.bashrc    # atau: source ~/.zshrc
hermes

# dijalankan admin lebih dulu
sudo npx playwright install-deps chromium

# lalu installer dijalankan sebagai user biasa, arahkan PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# bila gateway perlu hidup setelah logout
sudo loginctl enable-linger <service-user>

# TODO(trainer): sebutkan satu versi/tag Hermes sebagai acuan
# training, supaya perintah di deck ini bisa ditelusuri.
# Sumber: docs/hermes-training-blueprint.md §7 item 5

ls -la ~/.hermes/
cat ~/.hermes/config.yaml

hermes config get model
hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config unset terminal.backend

# API key: otomatis dirutekan ke .env, bukan config.yaml
hermes config set OPENROUTER_API_KEY sk-or-...

hermes model          # pilih provider dan model
hermes tools          # atur tool mana yang aktif
hermes gateway setup  # atur platform messaging
hermes config set     # set satu nilai
hermes config get     # baca satu nilai
hermes setup          # wizard lengkap

hermes version
hermes doctor
hermes chat -q "Balas dengan satu kata: siap"

/model custom:qwen-2.5             # model di custom endpoint
/model custom                      # deteksi model dari endpoint
/model openrouter:claude-sonnet-4  # kembali ke provider cloud

/model custom:local:qwen-2.5
/model custom:work:llama3

model:
  default: your-model-name
  provider: custom
  base_url: http://localhost:8000/v1
  api_key: your-key-or-leave-empty-for-local

hermes model
# Pilih "Custom endpoint (self-hosted / VLLM / etc.)"
# Masukkan: base URL, API key, nama model

providers:
  work:
    api: https://gpu-server.internal.corp/v1
    key_env: CORP_API_KEY
    transport: chat_completions

# TODO(trainer): Sumopod masuk lewat jalur custom endpoint di atas,
# tetapi keempat nilai ini belum ada dan TIDAK boleh dikarang:
#   1. base URL OpenAI-compatible Sumopod
#   2. nama env var API key-nya (mis. SUMOPOD_API_KEY)
#   3. nama model yang tersedia
#   4. apakah butuh extra_body / extra_headers khusus
#
# Catatan: "sumopod" tidak muncul sama sekali di dokumentasi resmi
# Hermes, jadi tidak ada provider bawaan bernama itu.
# Sumber: docs/hermes-training-blueprint.md §7 item 1

providers:
  sumopod:
    api: <TODO base URL>
    key_env: <TODO nama env var>
    transport: chat_completions

hermes config set model anthropic/claude-opus-4
hermes chat --model anthropic/claude-sonnet-4   # override sekali jalan
hermes config get model

hermes fallback          # memakai ulang picker dari hermes model
hermes fallback add
hermes fallback list     # atau: ls
hermes fallback remove   # atau: rm
hermes fallback clear

fallback_providers:
  - provider: openrouter
    model: anthropic/claude-sonnet-4

fallback_providers:
  - provider: custom
    model: my-local-model
    base_url: http://localhost:8000/v1
    key_env: MY_LOCAL_KEY   # nama env var berisi API key

hermes config get model
hermes config get fallback_providers --json
hermes chat -q "Model apa kamu?"

hermes chat --toolsets web,file,terminal
hermes chat --toolsets debugging   # composite — melebar jadi file + terminal + web
hermes chat --toolsets all         # semuanya

hermes tools   # UI curses, atur per platform

/tools list
/tools disable browser
/tools enable homeassistant

toolsets:
  - hermes-cli          # default untuk CLI

# 1. tanpa tool — jawaban dari ingatan model
hermes chat -q "Cari informasi <X> dan buat summary dengan sumbernya"

# 2. dengan web — agent mencari dulu
hermes chat --toolsets web -q "Cari informasi <X> dan buat summary dengan sumbernya"

hermes chat --toolsets web -q "Cari berita terbaru soal <X> dan sebutkan URL sumbernya"

# Profile kosong — perlu setup penuh
hermes profile create mybot

# Clone config saja dari profile sekarang
hermes profile create work --clone

# Clone semuanya dari profile sekarang
hermes profile create backup --clone-all

# Clone config dari profile tertentu
hermes profile create work2 --clone-from work

hermes profile list         # profile aktif ditandai *
hermes profile use work     # jadikan aktif
hermes profile use default  # kembali ke base
hermes profile show work    # detail lengkap
hermes profile delete mybot --yes

hermes -p work chat -q "Check the server status"
hermes --profile dev gateway start
hermes -p personal skills list

Profile: work
Path:    ~/.hermes/profiles/work
Model:   anthropic/claude-sonnet-4 (anthropic)
Gateway: stopped
Skills:  12
.env:    exists
SOUL.md: exists
Alias:   ~/.local/bin/work

hermes -p developer chat -q "<prompt identik>"
hermes -p researcher chat -q "<prompt identik>"

hermes profile list
hermes profile show <nama>
hermes -p <nama> chat -q "<prompt identik>"

hermes skills list

/skills
/skills search docker
/skills browse

hermes skills install official/research/arxiv
/skills install official/creative/songwriting-and-ai-music

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
metadata:
  hermes:
    tags: [my-tag, automation]
    category: my-category
---

# My Skill

## When to Use
Use this skill when the user asks about [specific topic]
or needs to [specific task].

## Procedure
1. First, check if [prerequisite] is available
2. Run `command --with-flags`
3. Parse the output and present results

## Pitfalls
- Common failure: [description]. Fix: [solution]
- Watch out for [edge case]

## Verification
Run `check-command` to confirm the result is correct.

For API details, load the reference: `skill_view("my-skill", "references/api-docs.md")`

mkdir -p ~/.hermes/skills/my-category/my-skill
# tulis SKILL.md
hermes chat -q "/my-skill bantu saya dengan hal itu"

hermes skills list | grep my-skill
hermes chat -q "/my-skill <tugas>"

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/contacts.readonly
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/documents

# TODO(trainer): konfirmasi ke IT sebelum hari-H
#   - apakah domain memakai Google Advanced Protection
#   - akun mana yang boleh dipakai peserta (kerja atau pribadi)
# Peserta dengan Advanced Protection TIDAK bisa menyelesaikan
# alur ini sampai admin meng-allowlist OAuth client ID.
# Sumber: docs/hermes-training-blueprint.md §7 item 6

GSETUP="python ${HERMES_HOME:-$HOME/.hermes}/skills/productivity/google-workspace/scripts/setup.py"

# 0. Cek dulu — kalau mencetak AUTHENTICATED, lewati ke pemakaian
$GSETUP --check

# 1. Daftarkan client secret yang sudah diunduh
$GSETUP --client-secret /path/to/client_secret.json

# 2. Minta auth URL
$GSETUP --auth-url

# 3. Tukar kode dengan token
$GSETUP --auth-code "URL_YANG_ANDA_TEMPEL"

# 4. Verifikasi
$GSETUP --check

GAPI="python ${HERMES_HOME:-$HOME/.hermes}/skills/productivity/google-workspace/scripts/google_api.py"

$GAPI gmail search "is:unread" --max 10
$GAPI gmail search "from:[email protected] newer_than:1d"
$GAPI gmail search "has:attachment filename:pdf newer_than:7d"
$GAPI gmail get MESSAGE_ID
$GAPI gmail send --to [email protected] --subject "Hello" --body "Message text"
$GAPI gmail send --to [email protected] --subject "Report" --body "<h1>Q4</h1>" --html
$GAPI gmail reply MESSAGE_ID --body "Thanks, that works for me."
$GAPI gmail labels
$GAPI gmail modify MESSAGE_ID --add-labels LABEL_ID

$GAPI calendar list
$GAPI calendar list --start 2026-03-01T00:00:00Z --end 2026-03-07T23:59:59Z
$GAPI calendar create --summary "Team Standup" \
  --start 2026-03-01T10:00:00-07:00 --end 2026-03-01T10:30:00-07:00
$GAPI calendar create --summary "Review" \
  --start 2026-03-01T14:00:00Z --end 2026-03-01T15:00:00Z \
  --attendees "[email protected],[email protected]"
$GAPI calendar delete EVENT_ID

$GAPI drive search "quarterly report" --max 10
$GAPI drive search "mimeType='application/pdf'" --raw-query --max 5
$GAPI drive get FILE_ID
$GAPI drive upload /path/to/report.pdf
$GAPI drive create-folder "Reports"
$GAPI drive share FILE_ID --email [email protected] --role reader
$GAPI drive download FILE_ID --output ~/doc.pdf
$GAPI drive delete FILE_ID            # ke trash, bisa dibatalkan

$GAPI sheets create --title "Q4 Budget"
$GAPI sheets get SHEET_ID "Sheet1!A1:D10"
$GAPI sheets update SHEET_ID "Sheet1!A1:B2" --values '[["Name","Score"],["Alice","95"]]'
$GAPI sheets append SHEET_ID "Sheet1!A:C" --values '[["new","row","data"]]'

$GAPI docs get DOC_ID
$GAPI docs create --title "Meeting Notes"
$GAPI docs append DOC_ID --text "Additional content to append"

gws slides presentations create
gws slides presentations get
gws slides presentations batchUpdate

gws slides --help                      # resource dan method yang tersedia
gws schema slides.presentations.create # params dan tipe sebuah method
gws schema drive.files.list            # params, tipe, default

gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'

gws auth setup     # sekali: siapkan Cloud project, aktifkan API, login
gws auth login     # login berikutnya / pilih scope

$GSETUP --check                          # harus: AUTHENTICATED
$GAPI gmail search "is:unread" --max 3
$GAPI calendar list
$GAPI drive search "report" --max 3

hermes                          # mulai chat
hermes chat -q "..."            # satu pertanyaan, lalu keluar
hermes chat --toolsets web      # sesi dengan toolset tertentu
hermes doctor                   # diagnosa kalau ada yang aneh
hermes update                   # perbarui

hermes model                    # pilih provider/model, tambah provider baru
hermes config get model
hermes config set model <provider>/<model>
hermes fallback                 # atur fallback

hermes profile list
hermes profile create <nama> --clone
hermes profile use <nama>
hermes profile show <nama>
hermes -p <nama> chat -q "..."  # sekali jalan, tanpa mengubah default

hermes skills list
hermes skills install official/<kategori>/<nama>
hermes tools
mkdir -p ~/.hermes/skills/<kategori>/<nama>   # lalu tulis SKILL.md

GSETUP="python ${HERMES_HOME:-$HOME/.hermes}/skills/productivity/google-workspace/scripts/setup.py"
GAPI="python ${HERMES_HOME:-$HOME/.hermes}/skills/productivity/google-workspace/scripts/google_api.py"

$GSETUP --check
$GAPI gmail search "is:unread" --max 10
$GAPI calendar list
$GAPI drive search "report" --max 10
$GAPI sheets create --title "..."