Portable Hermes Agent
<p align="center">
<a href="README.md"><img src="https://img.shields.io/badge/Language-English-blue?style=for-the-badge" alt="English"></a>
<a href="README.zh-TW.md"><img src="https://img.shields.io/badge/Language-Traditional_Chinese-purple?style=for-the-badge" alt="Traditional Chinese"></a>
<a href="README.zh-CN.md"><img src="https://img.shields.io/badge/Language-Simplified_Chinese-red?style=for-the-badge" alt="Simplified Chinese"></a>
<a href="README.es.md"><img src="https://img.shields.io/badge/Language-Spanish-yellow?style=for-the-badge" alt="Spanish"></a>
<a href="README.ur-pk.md"><img src="https://img.shields.io/badge/Language-Urdu-green?style=for-the-badge" alt="Urdu"></a>
</p>
Windows용 포터블 AI 에이전트 — 100개의 도구, GUI, LM Studio를 통한 로컬 모델 지원, TTS, 음악, ComfyUI, 워크플로우, 도구 제작기. 설치 불필요. Docker 불필요. 관리자 권한 불필요.
NousResearch/hermes-agent (MIT License)을 기반으로 하며 비기술적 사용자들을 위해 광범위하게 맞춤 설정되었습니다.
기능 (Features)
데스크톱 GUI (Desktop GUI)
- 채팅, 사이드바, 세션 관리가 가능한 다크 테마 Tkinter 인터페이스
- 다국어 지원 — 영어, 전통 중국어(繁體中文), 간체 중국어(简体中文), 스페인어(Español)를 런타임 전환 가능
- 썸네일이 포함된 이미지 첨부 기능 (vision model 지원)
- 가이드 모드 — AI 모델 연결 없이도 작동
- 개별 서비스 구성을 위한 API 키 설정 마법사
- 파일, 네트워크 및 시스템 접근에 대한 세밀한 제어 기능을 제공하는 권한 패널
| 도구 세트 | 도구 수 | 기능 설명 |
|---|
| LM Studio | 10 | 모델 로드/언로드, HuggingFace 검색, 토큰화, 임베딩, 직접 채팅, API 키 관리, 모델 목록 검색 |
| ... | | |
| 더불어 웹 검색, 파일 작업, 브라우저 자동화, 코드 실행, 위임(delegation), 메모리, 스킬, 메시징, Home Assistant 등 내장된 hermes-agent 도구들이 모두 포함되어 있습니다. | | |
LM Studio 패널은 엔드포인트와 API 키를 애플리케이션 소스 외부의 활성 HERMES_HOME 디렉터리(.lmstudio_config)에 저장합니다. 두 업데이트 경로 모두 이 사용자 데이터를 보존하며, 릴리스 아카이브는 이를 제외합니다. 키 필드를 지우고 저장을 클릭하여 저장된 키를 제거할 수 있습니다. 저장된 키는 GUI 채팅에도 사용됩니다. 이 파일은 비공개로 유지하십시오. 인증이 필요한 SDK 모델 로딩에는 api_token을 지원하는 버전의 LM Studio Python SDK가 필요하며, 선택적 SDK 연결에 문제가 있더라도 REST 모델 검색 및 채팅 기능은 계속 사용할 수 있습니다.
확장 모듈 (Extension Modules)
aivrar에서 제공하는 세 가지 포터블 AI 생성 서버:
| 확장 모듈 | 포트 | 지원 모델 | GPU 요구 사양 |
|---|
| TTS Server | 8200 | Kokoro, XTTS, Dia, Bark, Fish, + 5개 이상 | 4 GB+ |
| ... | | | |
| 각 확장 모듈은 첫 사용 시 자동으로 설치됩니다. 시스템 종속성이 필요 없습니다. | | | |
워크플로우 엔진 (Workflow Engine)
데이터 흐름, 조건, 루프, 병렬 실행, 오류 처리 및 cron 스케줄링을 통해 체인 도구 호출(Chain tool calls)을 자동화된 파이프라인으로 연결할 수 있습니다.
런타임에 새로운 도구를 생성할 수 있습니다. 모든 REST API를 래핑하거나 사용자 지정 Python 핸들러를 작성하십시오. 도구는 세션 전반에 걸쳐 유지되며 자동으로 다시 로드됩니다.
가이드 모드 (Guided Mode)
API 키가 없어도 괜찮습니다. 내장된 1,054줄의 사용자 가이드를 사용하여 오프라인으로 채팅할 수 있습니다. 신규 사용자는 첫 AI 모델을 설정하는 단계별 안내를 받게 됩니다.
빠른 시작 (Quick Start)
1. 다운로드
Releases에서 최신 portable-hermes-agent-v*.zip을 다운로드한 후, 일반 폴더에 압축을 해제하십시오.
권장 경로:
C:\Users\YourName\Portable-Hermes-Agent
C: extbackslash Program Files와 같은 보호된 폴더는 피하십시오.
2. 시작 (Start)
다음 명령을 더블클릭합니다:
최초 실행 시, START.bat이 포터블 설정을 자동으로 실행합니다. 이 과정에서 임베디드 Python, 종속성(dependencies), LM Studio SDK, Node.js 도구 등이 해당 폴더에만 다운로드됩니다. 관리자 권한은 필요하지 않습니다.
수동 설정:
PowerShell 사용자는 다음을 실행할 수 있습니다:
3. 다시 시작하기
START.bat :: 가장 쉬운 GUI 실행
UPDATE.bat :: 가장 안전한 원클릭 업데이트
hermes_gui.bat :: GUI 모드
...
업데이트
Portable Hermes는 두 개의 독립적인 업데이트 채널을 가지고 있습니다. 하나를 업데이트한다고 해서 다른 것이 자동으로 업데이트되지는 않습니다.
| 업데이트 채널 | 업데이트하는 내용 | 실행 방법 |
|---|
| Portable Hermes 배포판 | Windows 런처, 통합 기능, 포터블 도구 및 이 저장소로 테스트된 Hermes 버전 | Hermes를 종료한 후 UPDATE.bat을 더블클릭합니다 |
| Upstream Hermes Agent | NousResearch/hermes-agent의 최신 핵심 에이전트 코드 | Hermes를 시작하고 업스트림 업데이트기를 확인하거나 실행하도록 요청합니다 |
가장 정상적이고 안전한 유지보수 경로를 위해서는 다른 Hermes 창과 게이트웨이를 닫고 다음을 더블클릭합니다:
또는 다음을 실행합니다:
hermes.bat update --backup --yes
이 명령어는 aivrar/portable-hermes-agent에서 업데이트를 수행하고, 요청 시 백업을 만들며, .hermes/, .hermes/custom_tools/, .hermes/extensions/, extensions/, 및 python_embedded/와 같은 런타임 폴더는 보존합니다. 포터블 Node.js 런타임은 HERMES_HOME/node/ 아래에 저장되므로, 시스템 Node 설치를 수정하지 않고도 두 가지 유형의 업데이트 모두에서 살아남습니다.
만약 최신 업스트림 Hermes 코드도 원한다면, Portable 업데이트 후 Hermes를 시작하고 다음과 같이 요청합니다:
업스트림 Hermes Agent에 업데이트가 있는지 확인해 주세요. 아직 아무것도 설치하지 마세요.
그런 다음, 사용 가능한 업데이트를 원하면 다음과 같이 요청합니다:
Portable Hermes를 보존하면서 업스트림 Hermes Agent를 업데이트해 주세요. 완료되면 다시 시작해야 하는지 알려주세요.
성공적인 업스트림 업데이트 후에는 실행 중인 프로세스가 새로운 Python 모듈을 로드할 수 있도록 Hermes를 재시작합니다. Git 체크아웃은 정확한 앞/뒤 개수를 보고할 수 있지만, 릴리스 ZIP 파일은 Git 기록이 없으므로 대신 ZIP 오버레이 모드를 보고하며 여전히 최신 업스트림 코드를 설치할 수 있습니다.
대부분의 사용자는 매일 업데이트할 필요가 없습니다. 새로운 릴리스, 수정 사항 또는 보안 공지가 게시되었을 때 포터블(Portable) 업데이트러를 실행하거나 (또는 격주로), 최신 Hermes 기능을 원한다면 주간 단위로 상위 저장소(upstream)를 확인하십시오. 매일 확인할 필요는 없습니다.
전체 워크플로우, 백업, 릴리스-ZIP 동작 방식 및 문제 해결 방법은 **Portable Hermes 업데이트 유지하기**를 참조하십시오.
4. AI 모델 연결
클라우드 (2분, 무료):
- 파일 > API 키 설정 > OpenRouter
- openrouter.ai에서 가입합니다 (무료, 신용카드 불필요)
- API 키를 붙여넣습니다
- 채팅을 시작합니다
로컬 (NVIDIA GPU 필요):
- LM Studio를 다운로드합니다
- 모델을 다운로드하고 서버를 시작합니다
- 도구 > GUI의 LM Studio
- 모델을 로드하고 '채팅에 사용(Use for Chat)'을 클릭합니다.
요구 사항 (Requirements)
- Windows 10/11
- 인터넷 연결 (클라우드 AI용) 또는 NVIDIA GPU 8GB 이상 (로컬 AI용)
- 관리자 권한 불필요, 시스템 Python 불필요, Docker 불필요
문서화 (Documentation)
에이전트 내부에 검색 가능한 사용자 가이드가 구축되어 있습니다. 무엇이든 질문하거나 search_guide 도구를 사용하십시오. PDF 매뉴얼은 모든 릴리스에 포함됩니다.
주요 주제: 시작하기, API 설정, 인터페이스, 권한, LM Studio 로컬 모델, 확장 기능 (TTS/음악/ComfyUI), 모든 100개 도구, 사용자 지정 도구 생성, 워크플로우 및 AI 용어집.
아키텍처 (Architecture)
기여자 (Credits)
라이선스 (License)
MIT 라이선스 — 자세한 내용은 LICENSE를 참조하십시오.
원본 프레임워크 저작권 (c) 2025 Nous Research.