본문으로 이동

Hermes: 두 판 사이의 차이

학교의 모든 지식. SMwiki
잔글 설치
1번째 줄: 1번째 줄:
== 개요 ==
== 개요 ==


=== 설치 ===
=== 지원 환경 ===
{| class="wikitable"
!과정
!설명
!비고
|-
|준비
|
|sudo apt update
sudo apt install -y curl
|-
|설치
|필요한 것들이 자동 설치되는데, 꽤 걸린다.
|<nowiki>curl -fsSL https://openclaw.ai/install.sh | bash</nowiki>
|-
|확인
|버전 출력되면 성공.
이후 자동으로 설정 진행.
|openclaw --version
|}
 
 
 
== 지원 환경 ==
지원되는 운영체제와 요구사항은 다음과 같습니다.
지원되는 운영체제와 요구사항은 다음과 같습니다.


52번째 줄: 29번째 줄:
|}
|}


== 준비물 ==
=== 설치 ===
설치 전에 다음을 준비합니다.
{| class="wikitable"
!과정
!설명
!비고
|-
|준비
|파이썬 기반이라, 파이썬이 필요하다.
|sudo apt update
sudo apt install -y curl


* 웹서버 접근 권한 또는 로컬 서버 환경
sudo apt install -y python3 python3-venv python3-pip
* 데이터베이스 생성 권한 (운영 환경)
|-
* Hermes 설치 파일 또는 Git 소스
|설치
|공식 홈페이지에서 손쉽게 안내한다.
터미널에서 설치하는 게 간편하지. 웬만한 것들은 자동으로 해주니까.


== 설치 절차 ==
* 필요한 것들이 자동 설치되는데, 꽤 걸린다.
 
* 설치할 때 이것저것 묻는데, openclaw가 있으면 통합할거냐고도 물어본다.
=== 1. 설치 파일 얻기 ===
* 설치할 때 로그인이 필요하다. 링크를 주는데, 거기 로그인해서 구독제를 선택한다.(free 있음) 카드와 연결하면 됨. 이걸 해야 다음단계로 진행된다.
Git으로 소스를 가져오거나 공식 배포 파일을 다운로드합니다.
* 툴 선택에선 그냥 맘 편하게 다 체크하면..
 
* 게이트웨이는.. LLM 중계자인데... 잘 모르면 설치하는 게 편할 듯.
# Git
|https://hermes-agent.nousresearch.com/
<source lang="bash">
|-
git clone https://github.com/example/hermes.git
|확인
cd hermes
|버전 출력되면 성공.
</source>
이후 자동으로 설정 진행.
 
|hermes --version
# 또는 배포 파일
hermes doctor
[source|https://example.com/hermes/releases]
|}
 
=== 2. 의존성 설치 ===
PHP 의존 패키지를 설치합니다.
 
<source lang="bash">
composer install
</source>
 
=== 3. 데이터베이스 생성 ===
운영 환경에서는 먼저 DB를 생성합니다.
 
# MariaDB 예시
<source lang="sql">
CREATE DATABASE hermes DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'hermes_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON hermes.* TO 'hermes_user'@'localhost';
</source>
 
=== 4. 웹 서버 설정 ===
Apache 또는 Nginx에서 설치 경로를 웹root로 연결합니다.
 
* Apache: `DocumentRoot` 설정
* Nginx: `root` 설정과 `index.php` 처리
 
=== 5. 초기화 실행 ===
설치 스크립트 또는 웹 초기화 페이지를 실행합니다.
 
* 웹: `http://your-domain/install.php`
* CLI: `php bin/hermes install`
 
== 기본 설정 ==
설치 후 `LocalSettings.php`(미디어위키) 또는 Hermes 전용 설정 파일에서 값을 조정합니다.


=== 설정 ===
{| class="wikitable"
{| class="wikitable"
|+ 권장 설정 항목
!과정
|-
!설명
! 항목
!비고
! 권장값
! 설명
|-
| 언어
| ko
| 위키 언어
|-
| 업로드 허용
| true
| 파일 업로드 활성화
|-
| 로그 레벨
| warning
| 로그 출력 수준
|-
|-
| 캐시
|설정 시작
| enabled
|LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯;
| 캐시 활성화
|hermes setup
|}
|}
기본 설정 예시:
<source lang="php">
$wgLanguageCode = 'ko';
$wgEnableUploads = true;
$wgLogLevel = 'warning';
</source>
== 확인 방법 ==
설치가 성공했는지 확인합니다.
* Hermes 메인 페이지 접속
* `Hermes/변경이력` 페이지 존재 확인
* 관리자 패널에서 상태 확인
== 자주 나는 오류 ==
=== 업로드 불가 ===
* 웹서버 `upload_max_filesize` 설정 확인
* PHP `memory_limit` 확인
=== 데이터베이스 연결 오류 ===
* DB 사용자 권한 재확인
* `host`, `port`, `charset` 설정 확인
=== 웹서버 404 오류 ===
* DocumentRoot 또는 `root` 경로 확인
* `index.php` 처리 규칙 확인
[[분류:Hermes]]
[[분류:Hermes]]

2026년 6월 20일 (토) 13:37 판

개요

지원 환경

지원되는 운영체제와 요구사항은 다음과 같습니다.

요구사항
항목 요구 조건
운영체제 Linux (Ubuntu 20.04+), macOS 12+, Windows 10+
PHP 8.2 이상
데이터베이스 MariaDB 10.6+, MySQL 8+, PostgreSQL 13+, SQLite 3
웹서버 Apache 2.4+, Nginx + PHP-FPM
메모리 2GB 이상 (권장 4GB)
저장 공간 1GB 이상

설치

과정 설명 비고
준비 파이썬 기반이라, 파이썬이 필요하다. sudo apt update

sudo apt install -y curl

sudo apt install -y python3 python3-venv python3-pip

설치 공식 홈페이지에서 손쉽게 안내한다.

터미널에서 설치하는 게 간편하지. 웬만한 것들은 자동으로 해주니까.

  • 필요한 것들이 자동 설치되는데, 꽤 걸린다.
  • 설치할 때 이것저것 묻는데, openclaw가 있으면 통합할거냐고도 물어본다.
  • 설치할 때 로그인이 필요하다. 링크를 주는데, 거기 로그인해서 구독제를 선택한다.(free 있음) 카드와 연결하면 됨. 이걸 해야 다음단계로 진행된다.
  • 툴 선택에선 그냥 맘 편하게 다 체크하면..
  • 게이트웨이는.. LLM 중계자인데... 잘 모르면 설치하는 게 편할 듯.
https://hermes-agent.nousresearch.com/
확인 버전 출력되면 성공.

이후 자동으로 설정 진행.

hermes --version

hermes doctor

설정

과정 설명 비고
설정 시작 LLM 모델 등 연결을 하게 되는데... 이건 좀 공부가 필요할 듯; hermes setup