# Xisom Edge AI Box & Runtime

> 실시간 예측 분석, 이상 감지, 운영 최적화를 위한 산업용 엣지 AI 플랫폼.

## Overview

- [제품 개요](https://xisom-docs.pages.dev/ko/product-overview/): Xisom Edge AI Box 및 런타임이 무엇이며, 누구를 위한 것이고, 산업용 스택에 어떻게 들어맞는지 설명합니다.

## Install & Deploy

- [오프라인 번들 설치](https://xisom-docs.pages.dev/ko/install-deploy/offline-bundle-install/): 오프라인 릴리스 번들로 에어갭 사이트에 Xisom Edge AI Box를 설치합니다 — 이미지 로드, 설치 프로그램 실행, 시크릿 설정, 스택 기동, 헬스 검증까지.
- [빠른 시작](https://xisom-docs.pages.dev/ko/install-deploy/quickstart/): 15분 안에 Xisom Edge AI Box에서 첫 추론을 실행합니다.
- [하드웨어 설정](https://xisom-docs.pages.dev/ko/install-deploy/hardware-setup/): Xisom Edge AI Box를 프로비저닝하고, 실행 공급자 모드를 선택한 뒤 네트워크에 연결합니다.
- [첫 추론](https://xisom-docs.pages.dev/ko/install-deploy/first-inference/): 모델을 시드하고, 데이터소스를 활성화한 뒤 실시간 예측값이 대시보드에 나타나는 것을 확인합니다.

## Configure

- [입력 데이터소스 연결](https://xisom-docs.pages.dev/ko/configure/input-datasources/): 센서 및 공정 데이터를 Xisom 런타임으로 스트리밍합니다 — OPC-UA, MQTT 또는 CSV 소스를 추가하고, 태그를 매핑하고, 모델을 페어링하고, 활성화한 뒤 추론을 시작합니다.
- [출력 데이터소스](https://xisom-docs.pages.dev/ko/configure/output-datasources/): 예측값과 설정값을 외부 시스템으로 라이트백합니다 — OPC-UA, MQTT 또는 Modbus 출력을 구성하고 테스트 쓰기로 검증합니다.

## Troubleshooting

- [문제 해결](https://xisom-docs.pages.dev/ko/troubleshooting/): Xisom Edge AI Box의 일반적인 문제를 진단하고 해결하기 위한 증상 중심 런북입니다.
- [GPU 미사용 — CUDA 오류 500](https://xisom-docs.pages.dev/ko/troubleshooting/gpu-cuda-error-500/): GPU가 설치되어 있는데도 추론 컨테이너가 "CUDA failure 500"을 로깅하고 CPU로 폴백합니다.
- [GPU 예상 시 CPU에서 실행됨](https://xisom-docs.pages.dev/ko/troubleshooting/execution-provider-fallback/): GPU가 동작하는데도 추론이 더 낮은 실행 공급자(TensorRT → CUDA → CPU)로 저하됩니다.
- [데이터소스 다운 또는 장애](https://xisom-docs.pages.dev/ko/troubleshooting/datasource-down-or-faulted/): OPC-UA / MQTT / CSV 데이터소스가 스트리밍을 멈추거나, 행에 장애 표시가 나타납니다.
- [프런트엔드 / 백엔드 버전 불일치](https://xisom-docs.pages.dev/ko/troubleshooting/version-drift-fe-be/): 정보 패널이 프런트엔드와 백엔드 간 버전 불일치를 호박색으로 강조합니다.
- [디스크 가득 참 / 데이터베이스 무한 증가](https://xisom-docs.pages.dev/ko/troubleshooting/sqlite-retention-disk/): 관측성 데이터베이스가 실제 데이터보다 훨씬 커지며 디스크를 가득 채웁니다.
- [컨테이너가 unhealthy로 표시되나 서비스는 정상](https://xisom-docs.pages.dev/ko/troubleshooting/healthcheck-ipv6-false-negative/): 컨테이너가 트래픽을 정상 처리하는데도 unhealthy로 보고됩니다 — 헬스 프로브 거짓 음성.

## Reference

- [API 레퍼런스](https://xisom-docs.pages.dev/ko/api-reference/overview/): Xisom 런타임이 노출하는 REST 및 gRPC API.

## Translations

- [English](https://xisom-docs.pages.dev/): English documentation
- [한국어 (Korean)](https://xisom-docs.pages.dev/ko/): 한국어 (Korean) documentation
- [Tiếng Việt (Vietnamese)](https://xisom-docs.pages.dev/vi/): Tiếng Việt (Vietnamese) documentation