AIRGAP StudioAIRGAP Studio

시스템 요구사항

AIRGAP Studio 설치를 위한 시스템 요구사항

시스템 요구사항

AIRGAP Studio는 인터넷 연결 없이 동작하는 오프라인 AI IDE입니다. 본 페이지는 안정적인 동작을 위한 하드웨어/소프트웨어 요구사항을 정리합니다.

운영체제

항목최소권장
WindowsWindows 10 64-bit (버전 1903 이상)Windows 11

macOS / Linux 는 현재 미지원 입니다.

메모리 (RAM)

항목최소권장
RAM16 GB32 GB

IDE + AI 엔진(llama-server) + 모델이 동시 실행되므로 16 GB 미만은 권장하지 않습니다.

GPU

AIRGAP Studio 의 AI 엔진은 Vulkan 백엔드를 사용합니다. NVIDIA, AMD, Intel Arc 모든 Vulkan 지원 GPU 호환.

항목최소권장
GPUVulkan 지원 GPU (4 GB VRAM 미만은 CPU 폴백 자동)Vulkan 지원 GPU, 6 GB+ VRAM (Qwen3 8B 쾌적)

CUDA 드라이버는 필요 없습니다. Vulkan 드라이버 (Windows Update 또는 GPU 제조사 드라이버에 포함)만 있으면 됩니다.

VRAM 4 GB 미만 — 자동 CPU 폴백

Launcher 의 GpuFallback 메커니즘이 VRAM 4096 MB 미만을 감지하면 자동으로 CPU 추론 모드로 전환합니다. AI 응답이 느려지나 정상 동작합니다.

경량 모델(Qwen3 1.7B, Granite 4.0 Micro)을 사용하면 4 GB 환경에서도 GPU 가속 가능합니다.

디스크 공간

항목크기
Standard 통합팩 인스톨러~4.9 GB
설치 후 (IDE + llama-server + Qwen3 8B 모델)~7 GB
권장 여유 공간10 GB 이상 (20 GB SSD 권장)

필수 / 선택 소프트웨어

항목필요성비고
llama-server (AI 엔진, Vulkan)필수Standard 통합팩에 동봉 — 별도 설치 불필요
Qwen3 8B 모델 (.gguf)필수Standard 통합팩에 동봉. 추가 모델은 Modelpack 인스톨러로
VSCodium 1.109.x필수인스톨러에 동봉 (VS Code 가 아닌 VSCodium 오픈소스 빌드)
Node.js 18+ (24.x 권장)선택MCP 서버 실행용. AIRGAP Studio 자체 동작에는 불필요
Vulkan 드라이버필수NVIDIA / AMD / Intel Arc 모두 가능. CUDA 무관

옛 버전에서 필요했던 Ollama 는 더 이상 필요하지 않습니다 (v1.1.0 부터 llama-server 로 교체됨).

네트워크

AIRGAP Studio 의 핵심 기능 (로컬 AI 코딩 어시스턴트, 인라인 자동완성, RAG 채팅) 은 인터넷 연결 불필요.

다음 기능은 인터넷 연결이 필요합니다 (선택):

  • Foundation Provider (OpenAI, Anthropic, Gemini 등) — AIRGAP Lite Assistant 의 opt-in 기능
  • 외부 MCP 원격 서버 연결
  • Figma MCP (localhost:3845, Figma Desktop 사용 시)

포트 사용

포트용도설정
11434llama-server (AI 엔진)자동 기동
11433Compatibility Proxy자동 기동
9222Chrome DevTools (dev 모드)dev-launcher.ps1 사용 시만

진단

설치 후 정상 동작 확인:

  1. AIRGAP Studio 실행
  2. PowerShell: Invoke-WebRequest http://127.0.0.1:11434/health -UseBasicParsing → HTTP 200
  3. Activity Bar 의 AIRGAP 아이콘 클릭 → Lite Assistant 채팅창 표시 확인

문제 발생 시 LLM 서버 트러블슈팅 또는 Compatibility Proxy 문서 참고.