Tutorial 12: Nix & NixOS Setup

튜토리얼 12: Nix & NixOS 설정

Hermes Agent 튜토리얼 시리즈에 다시 오신 것을 환영합니다! 이번 포스트에서는 Nix 및 NixOS 시스템에 Hermes Agent를 설치하는 방법을 살펴보겠습니다. 그런데 한 가지 중요한 점이 있습니다 — 공식 문서가 변경되었고, Nix는 더 이상 공식 지원 설치 경로가 아닙니다. 하지만 걱정하지 마세요! 여전히 선택지는 있으며, 필요한 모든 것을 알려드리겠습니다.

무엇이 바뀌었나?

Hermes 팀은 설치 과정을 대폭 간소화했습니다. 여러 설치 경로를 유지하는 대신, 이제 모든 사용자에게 유니버설 인스톨러를 권장합니다 — Nix 사용자도 포함해서요. Nix 지원은 이제 “최선의 노력(best-effort)” 수준으로, 작동할 수도 있지만 공식적으로 테스트되거나 보장되지는 않습니다.

권장 경로: 유니버설 인스톨러

대부분의 사용자에게 Hermes Agent를 실행하는 가장 쉬운 방법은 한 줄 설치 명령어입니다. Linux, macOS, WSL2, 심지어 Android(Termux)에서도 작동합니다:

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

네이티브 Windows에서는 PowerShell을 사용하세요:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

인스톨러가 Python, Node.js, ripgrep, ffmpeg, 저장소 클론, 가상 환경, 전역 hermes 명령어까지 모든 것을 자동으로 처리합니다. 설치가 끝나면 바로 대화를 시작할 수 있습니다.

Nix 전용 설정은 어떻게 하나요?

이미 Nix를 사용 중이라면(NixOS, macOS 또는 Linux에서), 여전히 전용 설정 경로가 있습니다. Nix flake, 선언적 NixOS 모듈, 선택적 컨테이너 모드를 제공합니다. 자세한 내용은 공식 문서의 Nix & NixOS 설정 가이드를 확인하세요.

하지만 우리의 조언은 이렇습니다: 먼저 유니버설 인스톨러를 시도해 보세요. 공식 지원 경로이며, “그냥 작동하도록” 설계되었습니다.

사전 요구 사항: 간단하게 유지하세요

인스톨러를 실행하기 전에 다음이 있는지 확인하세요:

• Git (Windows 이외의 모든 플랫폼에서 필요)
• Linux에서 curl 및 xz-utils (인스톨러가 Node.js를 .tar.xz 아카이브로 다운로드합니다)
• Debian/Ubuntu에서 g++ 또는 build-essential (데스크톱 앱을 사용할 계획인 경우에만)

이것만 있으면 됩니다! Python, Node.js, ripgrep, ffmpeg를 수동으로 설치할 필요가 없습니다. 인스톨러가 누락된 것을 감지하여 자동으로 설치합니다.

Debian/Ubuntu에서는 다음 명령어로 모든 것을 준비할 수 있습니다:

sudo apt install curl xz-utils build-essential

설치 후

인스톨러가 완료되면 셸을 새로고침하고 대화를 시작하세요:

source ~/.bashrc   # 또는: source ~/.zshrc
hermes             # 대화 시작!

설정 구성하기

설치 후에는 전용 명령어로 세부 설정을 조정할 수 있습니다:

hermes model          # LLM 제공자와 모델 선택
hermes tools          # 활성화할 도구 구성
hermes gateway setup  # 메시징 플랫폼 설정
hermes config set     # 개별 구성 값 설정
hermes config get     # 개별 구성 값 확인
hermes setup          # 또는 전체 설정 마법사 실행

가장 빠른 방법: Nous Portal

프로 팁 하나 드리겠습니다: 도구별 API 키를 관리하기 싫다면 Nous Portal을 사용하세요. 하나의 구독으로 300개 이상의 모델과 Tool Gateway(웹 검색, 이미지 생성, TTS, 클라우드 브라우저)를 이용할 수 있습니다. 한 줄로 시작하세요:

hermes setup --portal

이 명령어 하나로 로그인, Nous를 제공자로 설정, Tool Gateway 활성화까지 한 번에 처리됩니다.

다른 머신에서 이동하시나요?

이미 다른 머신에서 Hermes를 실행 중이라면, 처음부터 모든 것을 다시 구축할 필요가 없습니다. hermes import로 전체 백업을 복원하거나, hermes profile import로 단일 에이전트를 가져올 수 있습니다. 참고로 프로필 내보내기는 보안상 자격 증명을 제외하므로 전체 백업이 아닙니다. 전체 백업은 hermes backup을 사용하세요.

마무리

Nix가 더 이상 공식 지원 설치 경로는 아니지만, 유니버설 인스톨러 덕분에 설정이 그 어느 때보다 쉬워졌습니다. 대부분의 사용자에게 — NixOS에서도 — 이것이 정답입니다. 문제가 발생하면 Nix 전용 가이드가 여전히 대안으로 남아 있습니다.

시리즈의 다음 편에서는 첫 번째 에이전트 구성에 대해 자세히 알아보겠습니다. 그때까지 즐거운 대화 되세요!