설치 전 준비사항
- GPU 서버 — NVIDIA GPU가 장착된 서버 (CUDA 12.x 지원)
- Container Runtime — Docker 24.x + NVIDIA Container Toolkit 또는 Kubernetes + GPU Operator
- LLM API Key — OpenAI, Anthropic, Google 등 사용할 LLM 서비스의 API Key
- 네트워크 — 외부 LLM API 접근을 위한 HTTPS(443) 아웃바운드 허용
시스템 요구사항
| 항목 | 최소 사양 | 권장 사양 |
|---|
| CPU | 16 Core | 32 Core 이상 |
| Memory | 32 GB | 64 GB 이상 |
| GPU | NVIDIA T4 16GB | NVIDIA A100 40GB+ |
| Storage | 500 GB NVMe SSD | 2 TB NVMe SSD |
| OS | Ubuntu 22.04 LTS | Ubuntu 22.04 LTS |
| CUDA | 12.0+ | 12.4+ |
Docker 배포
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
wget https://releases.seekerslab.com/kyra/v1.0/kyra-ai-agent-v1.0.tar.gz
tar -xzf kyra-ai-agent-v1.0.tar.gz
cd kyra-ai-agent-v1.0
cp .env.example .env
vi .env
docker compose --profile gpu up -d
docker compose ps
curl http://localhost:8080/health
LLM 모델 설정
API 기반 모델 설정
환경 변수 파일(.env)에 각 LLM 서비스의 API Key를 설정합니다.
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=AIza...
DEFAULT_LLM_MODEL=gpt-4o
FALLBACK_LLM_MODEL=claude-3-5-sonnet
로컬 LLM 배포 (선택)
docker compose --profile local-llm up -d
nvidia-smi
Vector DB 구성
RAG 파이프라인을 위한 Vector Database를 초기화합니다.
| 설정 항목 | 기본값 | 설명 |
|---|
| Vector DB | Milvus | 분산 벡터 데이터베이스 |
| 임베딩 차원 | 1536 | OpenAI text-embedding-3-small |
| 유사도 메트릭 | Cosine | 코사인 유사도 |
| 인덱스 유형 | IVF_FLAT | Inverted File Index |
초기 설정
- 관리자 계정 — 초기 관리자 이메일, 비밀번호, API Key 생성
- 에이전트 활성화 — FDS/Business/Sandbox 에이전트 중 사용할 에이전트 활성화
- 지식베이스 초기화 — 기본 보안 지식베이스(MITRE ATT&CK, CVE DB) 로드
- 연동 설정 — SIEM/SOAR/EDR 연동 테스트
설치 검증
| 검증 항목 | 확인 방법 | 기대 결과 |
|---|
| 서비스 상태 | docker compose ps | 모든 서비스 Up (healthy) |
| GPU 인식 | nvidia-smi inside container | GPU 디바이스 표시 |
| LLM API 연결 | POST /api/v1/test-llm | LLM 응답 수신 |
| Vector DB | GET /api/v1/health/vectordb | status: connected |
| RAG 검색 | POST /api/v1/test-rag | 관련 문서 반환 |
| 에이전트 상태 | GET /api/v1/agents/status | 활성 에이전트 표시 |