Naia
목차
  1. 1동영상 매뉴얼
  2. 2Naia OS 라이브 USB
  3. 3설치
  4. 3.1Naia OS 설치 (ISO)
  5. 3.2리눅스 앱 설치
  6. 4시작하기
  7. 4.1Naia 모델 가격 정책
  8. 4.2Naia-0.9-omni-24g 실시간 멀티모달 모듈
  9. 4.3라이브 데모
  10. 4.4Naia 모델 다운로드
  11. 4.5Naia 모델 상세 이용 (개발)
  12. 4.6Naia 모델 온라인 이용안내 (예정)
  13. 5메인 화면
  14. 6채팅
  15. 6.1개인 라디오 DJ와 행사 소개
  16. 7대화 기록
  17. 8작업 현황
  18. 9스킬 관리
  19. 10채널 연동
  20. 11에이전트
  21. 12시스템 진단
  22. 13워크스페이스
  23. 14브라우저
  24. 15패널 관리
  25. 16음성 대화
  26. 17설정
  27. 18도구 상세
  28. 19Naia 계정
  29. 20문제 해결
  30. 21오픈소스 활용 및 기여
← 목차로 돌아가기

3.2. 리눅스 앱 설치

기존 OS에 Naia를 단독 앱으로 설치합니다. 모든 설치 파일은 다운로드 페이지 또는 itch.io 에서 받을 수 있습니다.

Windows (권장 — 설치 프로그램)

시스템 요구사항

  • OS: Windows 10 / Windows 11 (x64)
  • 런타임: WebView2 (Edge가 설치되어 있으면 자동 포함)
  • Node.js: 설치할 필요 없음 (Naia 설치본에 필요한 Node.js 런타임이 포함됨)

설치 방법

  1. 다운로드 페이지에서 Naia-Shell-x86_64-setup.exe를 다운로드합니다
  2. 파일을 더블클릭하여 설치 마법사를 시작합니다
  3. 언어(한국어/영어)를 선택하고 설치 완료까지 따라갑니다
  4. 바탕화면 또는 시작 메뉴에서 Naia를 실행합니다

자동 업데이트: 앱이 실행 중일 때 새 버전이 출시되면 알림이 표시되고, 확인 시 자동으로 업데이트됩니다.

Node.js 안내: 일반 설치 사용자는 Node.js를 별도로 설치하거나 경로를 설정하지 않아도 됩니다. Node.js 22 이상은 소스 코드에서 직접 개발·빌드할 때만 필요합니다.

처음 표시되는 마이크 권한 창

음성 또는 마이크 기능을 처음 사용할 때 Windows WebView2가 localhost의 마이크 접근을 허용할지 물을 수 있습니다. 여기서 localhost는 외부 웹사이트가 아니라 PC 안에서 실행되는 Naia 앱 화면을 뜻합니다.

  • 음성 대화를 사용하려면 허용을 선택하세요.
  • 차단해도 텍스트 대화는 계속 사용할 수 있습니다.
  • 나중에 바꾸려면 Windows 설정 > 개인 정보 및 보안 > 마이크에서 마이크 접근 권한을 다시 켜세요.

MSI 설치 (IT 관리자용)

기업 배포 또는 그룹 정책 설치가 필요한 경우 .msi 패키지를 사용합니다:

msiexec /i Naia-Shell-x86_64.msi /quiet

Linux (Flatpak 권장)

시스템 요구사항

  • OS: Linux (Ubuntu, Fedora, Bazzite 등)
  • 디스플레이: Wayland 권장 (X11도 지원)
  • Flatpak 설치 시 별도 런타임 설치 없이 바로 사용 가능합니다.

Flatpak (권장)

가장 안전한 설치 방법입니다. 앱이 독립된 공간에서 실행되어 기존 시스템에 영향을 주지 않습니다.

다운로드 페이지에서 .flatpak 번들을 받아 터미널에서 설치합니다:

flatpak install --user ./Naia-Shell-x86_64.flatpak

동작 방식: Naia 앱은 독립된 공간에서 안전하게 실행됩니다. AI가 PC를 제어할 때만 필요한 권한을 사용합니다.

다른 형식

AppImage, DEB (Debian/Ubuntu), RPM (Fedora/RHEL)도 다운로드 페이지에서 받을 수 있습니다.

(개발자용) Flatpak 로컬 빌드 방법

소스 코드에서 직접 Flatpak 샌드박스 앱을 묶어내려면 다음 절차를 따릅니다.

  1. Flatpak 빌더 설치

    # Fedora / Bazzite
sudo dnf install flatpak-builder

# Ubuntu
sudo apt install flatpak-builder

  2. 빌드 종속성(SDK) 추가

    flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user flathub org.gnome.Platform//50 org.gnome.Sdk//50 org.freedesktop.Sdk.Extension.rust-stable//25.08 org.freedesktop.Sdk.Extension.node22//25.08 org.freedesktop.Sdk.Extension.llvm20//25.08

  3. 패키징 빌드 실행 프로젝트 루트 디렉토리(Naia-OS)에서 실행합니다.

    # build-dir에 컴파일 및 빌드 진행
flatpak-builder --user --install --force-clean build-dir flatpak/io.nextain.naia.yml

  4. 앱 실행

    flatpak run io.nextain.naia

개발 참고: Flatpak 내부에서 실행되는 AI 에이전트는 사용자의 호스트 환경을 조작하기 위해 agent/src/gateway/tool-bridge.ts 내부적으로 모든 execute_command 요청을 flatpak-spawn --host bash -c ... 형태로 래핑하여 처리합니다.

다음 목차4. 시작하기