본인의 PC(로컬 컴퓨터)에 Hermes Agent 및 Workspace를 직접 설치하여 평생 무료로 구동하는 방법을 소개

 

안녕하세요! 오늘은 비싼 클라우드 서버(Hostinger 등) 비용을 지불하지 않고, 본인의 PC(로컬 컴퓨터)에 Hermes Agent 및 Workspace를 직접 설치하여 평생 무료로 구동하는 방법을 소개해 드리려고 합니다.

Windows 환경에서는 WSL2(Windows Subsystem for Linux)를 활용하고, macOS 환경에서는 터미널(Terminal)을 활용해 맥북이나 데스크톱에 직접 나만의 AI 비서 작업실을 구축할 수 있습니다. 생각보다 간단하니 차근차근 따라와 보세요!

💻 1. 준비 단계: 도커(Docker) 설치하기

Hermes Workspace는 다양한 에이전트 환경과 대시보드를 묶어 부드럽게 실행하기 위해 Docker라는 가상화 시스템을 사용합니다.

  • Windows 사용자: 먼저 'Docker Desktop' 공식 홈페이지에서 다운로드하여 설치합니다. 설치 과정에서 WSL2 기반 엔진을 사용(Use the WSL 2 based engine)하라는 체크박스에 반드시 체크해야 합니다.
  • macOS 사용자: Mac용 'Docker Desktop' (본인의 사양에 맞게 Intel 또는 Apple Silicon 칩셋 버전 선택)을 설치하고 대시보드 구동 전에 미리 실행해 둡니다.

🛠️ 2. PC 설치 및 구동 단계 (터미널 작업)

Docker가 실행 중인 상태에서 Mac의 터미널(Terminal) 프로그램 또는 Windows의 WSL2 우분투(Ubuntu) 터미널을 열고 아래 명령어를 순서대로 입력합니다.

① 소스코드 다운로드 (Git Clone)

Hermes Workspace 오픈소스 저장소에서 내 컴퓨터로 프로젝트 파일들을 내려받습니다.

git clone https://github.com/moelueker/hermes-workspace.git
cd hermes-workspace

② 환경 변수 설정 (.env)

환경 설정 파일 복사본을 만들고, 텍스트 편집기(Nano 등)로 열어 발급받은 OpenRouter API 키를 입력해 줍니다.

cp .env.example .env
nano .env
💡 설정 파일 내 수정할 부분:
OPENROUTER_API_KEY=your_actual_api_key_here
(이 부분에 your_actual_api_key_here를 지우고 발급받은 진짜 API 키를 붙여넣은 뒤 저장하고 나옵니다. *Nano 편집기 기준: Ctrl+O 입력 후 엔터로 저장, Ctrl+X로 빠져나오기)

③ 컨테이너 빌드 및 로컬 실행

Docker를 이용해 내 PC에 에이전트 작업실 환경을 빌드하고 백그라운드에서 실행합니다.

docker-compose up --build -d

모든 다운로드와 이미지 빌드가 완료되면 터미널 창에 완료 메시지가 나타납니다.

🚀 3. 내 PC에서 대시보드 접속하기

설치가 정상적으로 완료되면 이제 외부 호스팅 서버 주소가 아닌, 내 컴퓨터 로컬 주소를 통해 웹 브라우저로 접속할 수 있습니다.

  1. 크롬(Chrome)이나 사파리(Safari) 브라우저를 켭니다.
  2. 주소창에 아래 주소를 입력하고 엔터를 누릅니다. 
    http://localhost:3000
    *(만약 템플릿 기본 포트가 다르게 지정되어 있다면 http://localhost:포트번호 형식으로 접속합니다.)*
  3. 화면에 시각적인 칸반 보드와 깔끔한 대시보드가 나타나면 완벽하게 성공입니다! 🎉

💡 로컬 PC 환경 전용 운영 팁

  • 내 컴퓨터 자원 소모 제어: 클라우드 서버와 달리 내 PC에서 구동하면 에이전트가 복잡한 웹 크롤링이나 소스코드 빌드 태스크를 수행할 때 컴퓨터 CPU와 RAM을 일시적으로 많이 사용할 수 있습니다. 컴퓨터가 버벅거린다면 Docker Desktop 설정 > Resources에서 사양 제한(예: CPU 2코어, RAM 4GB 제한)을 걸어두면 일상적인 PC 사용에 방해받지 않고 쾌적하게 쓸 수 있습니다.
  • OpenRouter 비용 관리는 동일: 내 PC에 설치했더라도 AI 모델의 두뇌 역할을 하는 데이터는 OpenRouter API를 거쳐 오기 때문에 비용이 발생합니다. API 대시보드 설정에서 월간 지출 한도(예: $20 제한)를 설정해 두는 안전장치는 똑같이 적용해 두시는 것을 권장합니다.

궁금한 점이 있으신가요?
설치 중 막히는 부분이나 에러 메시지가 뜬다면 언제든지 아래 댓글로 남겨주세요! 확인 후 답변해 드리겠습니다. 도움이 되셨다면 공감 부탁드립니다! 😊

댓글

댓글 쓰기

이 블로그의 인기 게시물

정부 무료 공공데이터 종류 총정리 & Python API 실전 호출 연동 가이드

이미지
  정부 무료 공공데이터 종류 총정리 & Python API 실전 호출 연동 가이드 "아이디어는 있는데 활용할 데이터가 없다고요?" 정부와 지자체가 무료로 제공하는 11,000개 이상의 공공데이터(Open API)를 활용하면 상권 분석, 부동산 추이, 날씨 연동 앱 등 수많은 서비스를 직접 구축할 수 있습니다. 카테고리별 공공데이터 종류부터 파이썬(Python)으로 상권 API를 연동하는 실전 코드 까지 한 번에 정리해 드립니다. 📌 목차 1. 수익화에 유용한 대표 공공데이터 6가지 분류 2. [실전 코드] Python으로 상권 정보 API 호출 & 데이터 파싱하기 3. API 연동 시 필수 주의사항 (디코딩 인증키 오류 해결) 4. 공공데이터 + AI(Claude/ChatGPT) 서비스 자동화 아이디어 5. 공공데이터포털 API 신청 3단계 절차 ✍️ 운영자 노트 저는 기상 데이터를 다루는 일을 하고 있어서 공공데이터포털의 기상청 API를 실무에서 꾸준히 씁니다. 처음 신청했을 때 가장 오래 헤맨 지점이 아래 3번의 Encoding/Decoding 인증키 구분 이었습니다 — 에러 메시지는 키가 등록되지 않았다고 나오는데, 실제 원인은 키 종류를 잘못 고른 것이었습니다. 같은 곳에서 시간을 버리지 않도록 트러블슈팅 섹션을 꼭 확인하세요. 1. 주요 공공데이터 종류 및 대표 Open API 공공데이터포털(data.go.kr)에서 다룰 수 있는 수천 가지 데이터 중,...
자세한 내용 보기

말 대신 화면을 녹화하면 AI가 그대로 따라합니다: 클로드(Claude) 화면 녹화 스킬 & Chrome 연동 가이드

이미지
  말 대신 화면을 녹화하면 AI가 그대로 따라합니다: 클로드(Claude) 화면 녹화 스킬 & Chrome 연동 가이드(2026.7월 기준 macOS만 가능) 복잡한 프롬프트 작성 없이 화면 작업 과정을 녹화하기만 하면 클로드가 스스로 웹을 조종해 반복 업무를 자동화합니다. 구체적인 설치부터 실전 활용 방법까지 정리했습니다. ✍️ 운영자 노트 이 블로그의 운영 작업(설정 변경·게시·검증) 상당 부분을 실제로 클로드 + Chrome 연동으로 처리하고 있습니다. 브라우저를 직접 조종하는 방식은 확실히 강력하지만, 화면 녹화(Record a Skill) 스킬 자체는 글 작성 시점 기준 macOS 전용 입니다. 윈도우 사용자는 아래 '함께 보면 좋은 글'의 윈도우 대안 정리를 먼저 확인하세요. 💡 어떤 업무를 스킬로 만들면 좋을까? (3가지 기준) 모든 일을 녹화할 필요는 없습니다. 다음 3가지 조건에 부합하는 업무일수록 자동화 효과가 극대화됩니다. 자주 반복하는 일: 매일/매주 정기적으로 수행하는 데이터 수집 및 정리 작업 직접 커넥터 연결이 안 되는 서비스: API나 전용 연동 도구가 없는 외부 웹사이트 활용 업무 글로 설명하기 어려운 일: 프롬프트로 조건과 순서를 일일이 기재하기 복잡한 마우스 클릭·타이핑 작업 🛠️ 사전 설치 및 설정 방법 step-by-step 1. 클로드 데스크톱(Claude Desktop) 앱 설정 클로드 데스크톱 앱 실행 후 좌측 메뉴에서 사용자 지정(Custom) 클릭 스킬(Skills) 탭 선택 후 우측 상단의 추가(Add) 클릭 메뉴 중 화면 녹화(Record...
자세한 내용 보기

Claude Code 하나로 논문 작성부터 심사까지: academic-research-skills 완벽 가이드

이미지
  Academic AI Tool Claude Code 하나로 논문 작성부터 심사까지: academic-research-skills 완벽 가이드 AI 환각을 차단하고 연구 생산성을 극대화하는 대학원생·연구원 필수 라이브러리 논문 작성 시 AI를 활용할 때 가장 두려운 순간은 "존재하지 않는 가짜 인용(Hallucination)" 이나 "기계가 쓴 듯한 진부한 문체" 때문일 것입니다. 오늘 소개할 Imbad0202/academic-research-skills 는 단순한 AI 자동 글쓰기 도구가 아닙니다. 연구자가 주도권을 쥐고 AI를 '학술 전문가 파트너'로 활용하도록 설계된 Claude Code 전용 프레임워크 입니다. 1. 왜 이 라이브러리를 써야 할까? 이 툴은 2026년 최신 연구 지표와 학술적 가이드라인을 반영하여 개발되었습니다. 핵심 철학은 "AI는 코파일럿(보조)이지, 필럿(주도자)이 아니다" 입니다. 엄격한 인용 검증 (Claim Audit): 논문에 포함된 인용 출처가 실제 주장과 일치하는지 3단계 앵커로 실시간 검증합니다. 개인 맞춤형 문체 학습 (Style Calibration): 기존에 본인이 작성했던 논문 어조를 학습하여 AI 특유의 상투적인 문체를 제거합니다. 다단계 동료 심사 모의 테스트 (Peer Reviewer): 제출 전 논문의 논리적 허점, 과장된 주장, 근거 부족을 미리 찾아냅니다. 전 과정 통합 관리: 연구 기획 → 문헌 조사 → 작성 → 검토 → 최종 출력(DOCX/PDF)을 원스톱 처리합니다. ✍️ 운영자 노트 — 논문을 쓰고 심사하는 입장에서 저는 대기과학 분야에서 실제로 논문을 쓰고 국제 학술지 심사(리뷰)에도 참여...
자세한 내용 보기