가이드

Home Assistant TTS를 자연스러운 로컬 목소리로

스마트홈 안내가 듣기 좋은지는 목소리에 달려 있습니다. 세탁이 끝났다, 누가 문 앞에 있다, 학교 갈 시간이다. 내 네트워크에서 돌아가는 자연스러운 목소리는 안내를 사적으로 지키고, 인터넷이 끊겨도 계속 작동합니다.

SuperClonica는 Home Assistant 내장 통합은 아니지만, 로컬 서버를 shell_command와 미디어 플레이어로 몇 줄 만에 연결할 수 있습니다. 이 가이드에서는 설정 방법과 자연스럽게 들리는 안내문 쓰는 법을 소개합니다.

목소리 보기 SuperClonica 엔진 설치

안내할 수 있는 것

모든 것이 내 네트워크에서 돌아갑니다. 인터넷은 처음 모델을 내려받을 때만 필요합니다.

  • 가전과 초인종 알림을 스마트 스피커로.
  • 날씨와 첫 일정을 알려 주는 아침 브리핑.
  • 정해진 시간의 가족 알림.
  • 차분하고 또렷한 목소리의 경보·안전 안내.

목소리를 무료로 고르기

아무 목소리 페이지에서 전형적인 안내문을 30~100자로 입력하고 언어를 고른 뒤 생성 버튼을 누르세요. 몇 초 만에 집에서 어떻게 들릴지 알 수 있습니다. 계정은 필요 없습니다.

Home Assistant 연결하기

고정된 메시지는 한 번만 읽혀 파일을 다시 쓰고, 문장이 바뀔 때만 새로 만드세요.

  • 네트워크 안의 컴퓨터에서 서버 실행: docker run -d -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cpu.
  • configuration.yaml에 shell_command를 추가해 curl로 JSON(text, voice, lang)을 보내고 WAV를 설정 폴더의 www에 저장하세요. 예: /config/www/tts/announce.wav.
  • www의 파일은 /local/로 제공되므로 안내는 http://내-HOME-ASSISTANT:8123/local/tts/announce.wav에 있습니다.
  • 자동화에서 shell_command를 실행한 뒤, 그 주소와 media_content_type music으로 media_player.play_media를 호출하세요.

자연스럽게 들리는 안내

안내는 한두 문장으로 짧게. 시각과 숫자는 “일곱 시 반”처럼 읽혀야 하는 대로 글자로 쓰세요. 숫자는 단순한 수로 읽힙니다. lang에는 글의 언어를 지정하고, 방이나 메시지 종류마다 다른 목소리를 주면 가족이 무슨 일인지 바로 압니다. 짧은 문장은 일반 CPU에서 1초보다 훨씬 짧게 걸립니다.

개인정보

서버와 오디오는 내 네트워크에 남습니다. www 폴더의 파일은 로그인 없이 열리므로, Home Assistant가 인터넷에서 접근 가능하다면 개인적인 내용을 그곳에 읽혀 두지 마세요. 음성 서버가 다른 컴퓨터에서 접근 가능하다면 SUPERCLONICA_API_KEY를 설정하세요.