> For the complete documentation index, see [llms.txt](https://melissa-industry.gitbook.io/openmascotai_hologram/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://melissa-industry.gitbook.io/openmascotai_hologram/5./openmascotai.md).

# OpenMascotAI 설치

캐릭터를 그리고 말하게 하는 소프트웨어는 **OpenMascotAI**입니다. 두 부분으로 되어 있습니다.

| 부분    | 어디에 설치              | 하는 일                                       |
| ----- | ------------------- | ------------------------------------------ |
| 서버    | 그래픽카드가 있는 **본체 PC** | 대화(LLM) · 음성 인식 · 음성 합성 · 감정 분석. 캐릭터의 "생각" |
| 클라이언트 | **SER8**            | 캐릭터를 그리고, 마이크 소리를 서버에 보내고, 답을 받아 말하게 함     |

자세한 설치법은 OpenMascotAI 설명서에 있습니다. 여기서는 홀로그램 기기에서 다르게 할 것만 적습니다.

* 서버 설치: [melissa-industry.gitbook.io/openmascotai](https://melissa-industry.gitbook.io/openmascotai) → 시작하기 → 서버 설치
* 클라이언트 설치: 같은 설명서 → 클라이언트 설치 → 첫 실행

## 1. 서버(본체 PC)

1. 설명서대로 서버를 설치하고 띄웁니다. 기본 포트는 **3545**(대화)와 **3546**(음성 파일)입니다.
2. 서버 관리 패널에서 음성 합성(TTS)과 음성 인식(ASR)을 **켭니다**. 기본값은 꺼져 있어서, 켜지 않으면 캐릭터가 말을 못 합니다.
3. 본체 PC의 **LAN IP 주소**(예: 192.168.0.10)를 적어 둡니다. 명령 프롬프트에서 `ipconfig`로 봅니다.
4. Windows 방화벽에서 3545 · 3546 포트를 같은 네트워크에 열어 둡니다(서버 설치 설명서에 있음).

## 2. 클라이언트(SER8)

1. 클라이언트를 SER8에 설치하고 실행합니다.
2. 설정 창 → 서버 탭에서 서버 IP에 **본체 PC의 LAN IP**를 넣고 확인을 누릅니다. 설정은 하단 **확인**을 눌러야 저장됩니다.
3. 캐릭터를 고릅니다(Live2D 또는 VRM). 처음에는 아무 캐릭터로 연결부터 확인합니다.
4. 설정 창 → 사운드 탭:
   * **출력 장치**를 XVF3800으로 지정합니다. 캐릭터 목소리가 반드시 마이크 어레이로 나가야 에코 제거가 됩니다.
   * **마이크**도 XVF3800으로 고릅니다.
5. 설정 창 → 기타 탭에서 **윈도우 시작 시 자동 실행**을 켭니다.
6. 표시 모니터를 ZEUSLAP으로 고릅니다(모니터가 둘 이상일 때).

## 3. 지금 할 수 있는 것

지금의 공개 클라이언트는 바탕화면용이라, 홀로그램 전용 세로 출력(좌우 반전 · 검정 배경 · 실제 크기)은 아직 없습니다. 그래도 다음은 됩니다.

* 세로로 돌린 모니터에 캐릭터가 서 있고, 말을 걸면 대답합니다(마이크 어레이 + 스피커).
* 바탕화면을 검정으로 하고 작업 표시줄을 자동 숨김으로 두면 유리에 비치는 것이 캐릭터뿐이 됩니다.
* 캐릭터 크기는 클라이언트의 크기 조절로 대략 맞춥니다. 실제 310 mm는 2560 px 기준 약 2,300 px입니다.
* 좌우 반전은 아직 소프트웨어에 없어서, 글자가 거울상으로 보입니다. 캐릭터는 좌우 대칭에 가까워 크게 거슬리지 않습니다.

[첫 전원](/openmascotai_hologram/6./first-power.md)에서 유리에 비친 상을 보며 세로 방향을 맞춥니다.

## 4. 기기에서 끌 기능

클라이언트 설정에서 다음을 꺼 둡니다. 홀로그램 기기 안에서는 뜻이 없거나 해롭습니다.

| 기능         | 왜 끄나                   |
| ---------- | ---------------------- |
| 리얼톡(화면 관찰) | 자기 화면(캐릭터)만 보게 됩니다     |
| 자비스(PC 조작) | 본체가 아니라 SER8을 조작하게 됩니다 |
| 캡처         | 쓸 일이 없습니다              |

## 5. 확인

* [ ] 클라이언트 상태가 "서버 연결됨"이다
* [ ] 입력창에 글을 쓰면 캐릭터가 **스피커로** 대답한다(SER8 내장 소리나 모니터 스피커가 아니라)
* [ ] 마이크에 말을 걸면 알아듣는다
* [ ] 캐릭터가 대답하는 동안 자기 목소리를 알아듣지 않는다(에코 제거 확인)
* [ ] SER8을 재부팅하면 클라이언트가 혼자 뜬다