インストールと初回起動

この章では、Hermes Desktopを導入して起動を確認し、自分に合った始め方を選びます。最初からすべての機能を有効にする必要はありません。まずは「起動して、チャットが打てる」ところまでを最短で目指します。

1. インストールする

OSによって配布方法が異なります。すでにHermes AgentのCLIを導入済みなら、ターミナルから起動する方法が手早いです。

配布物のファイル名、署名、更新方法は変わる可能性があります。第三者のミラーではなく公式サイトから取得してください。

hermes desktop

この方法では、現在の設定、キー、セッション、スキルをDesktop Appと共有します。

公式ガイドではDesktop AppはLinuxでも動作するとされています。CLIを公式インストーラーで導入し、hermes desktopを実行する方法を確認してください。

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

シェルスクリプトを実行する前に、組織のセキュリティ方針がある場合はスクリプトの内容と配布元を確認してください。管理対象端末では管理者の手順を優先します。

次の3つが確認できれば、インストールは成功です。

起動に失敗する場合は問題の切り分けを確認してください。

起動できたら、自分の状況に合わせて始め方を選びます。下にいくほど設定項目が増えますが、最小限から始めて後で広げて構いません。迷ったら最小限を選んでください。

「とにかく動かしたい」段階向けです。初回オンボーディングだけで完結します。

この段階では、承認モードや作業フォルダは初期設定のまま進めて問題ありません。詳しいモデル選びはモデルとプロバイダーを整えるで扱います。

ファイルを扱う実作業に入る前の、推奨の出発点です。最小限に次を足します。

作業フォルダを、対象プロジェクトまたは専用のテストフォルダに限定する。
承認モードを manual（UI表示は「手動」。承認が必要な操作の前に人が確認する）に設定する。既定は smart（UI表示は「スマート」。LLMレビュアーが低リスクのコマンドを自動承認する）なので、標準の安全運用では手動へ切り替えます。
「シークレットを伏せる」がオンであることを確認する。
コード編集を行うならファイルチェックポイントをオンにする。

安全設定の意味は安全に使う設定で詳しく扱います。チェックリストは安全に設定するための確認事項が便利です。

複数の用途を使い分けたい段階向けです。標準に次を足します。

高度な構成は、必要が出てから一つずつ足すのが安全です。最初から全部やろうとしないでください。

インストーラーが見つからない・古い: 第三者サイトではなく公式Downloadページから取得し直す。
hermes desktop が動かない: CLIが導入済みか、hermes にパスが通っているかを確認する。未導入なら公式インストーラーで入れる。
起動するがプロバイダーに繋がらない: オンボーディングをスキップした場合は設定画面から後で接続できる。詳細はプロバイダーを参照。
それでも起動しない: 問題の切り分けで症状から原因を絞り込む。

起動とモデル接続ができたら、いよいよ最初のチャットです。最初のチャットを成功させるに進み、安全に成功体験を積みましょう。