yeahhe365/AMC-WebUI

해결하는 문제

AMC WebUI는 AI 모델과 상호작용하기 위한 포괄적이고 로컬 우선적인 인터페이스를 제공합니다. 주로 Google Gemini의 네이티브 기능에 중점을 두면서도 OpenAI 표준 채팅 API와의 호환성을 유지합니다. 심층 추론, 실시간 오디오/비디오, 고급 도구 통합을 단일 콘솔로 통합하여 여러 인터페이스를 사용할 필요성을 없애줍니다.

작동 방식

Vite + React SPA로 구축된 이 프로젝트는 '로컬 우선' 원칙을 따르며, 채팅 데이터는 프라이버시와 속도를 위해 브라우저의 IndexedDB에 저장됩니다. 표준 정적 사이트, Docker Compose(프론트엔드와 Node.js API 프록시 결합), 또는 Cloudflare Pages의 정적 프론트엔드와 별도의 API 백엔드 등 세 가지 방식으로 배포할 수 있습니다. 이 시스템은 직접적인 브라우저-API 통신(BYOK)과 안전한 프록시를 위한 서버 측 키 관리를 모두 지원합니다.

대상 사용자

Gemini의 고급 기능(Live API 및 Thinking 모델 등)을 강력하고 프라이버시 중심적인 UI로 사용하려는 사용자, 그리고 여러 AI 제공업체와 MCP 도구를 관리하기 위한 통합 콘솔이 필요한 개발자.

주요 특징

• Gemini 네이티브 통합: Thinking(사고 과정 시각화), Live API(실시간 음성/시각), Gemini Files API를 완벽하게 지원합니다.
• 로컬 Python 샌드박스: Pyodide(WASM)를 사용하는 브라우저 내 Python 환경으로, numpy나 pandas와 같은 과학 라이브러리를 자동으로 로드합니다.
• Model Context Protocol (MCP): Node API를 통한 MCP 지원. 도구 호출에 대한 인간 개입(Human-in-the-loop) 승인 기능을 포함합니다.
• 라이브 Artifacts: 코드 블록을 대화형 HTML, SVG, Mermaid 다이어그램, Graphviz 차트로 자동 렌더링합니다.
• 엔터프라이즈 API 관리: Gemini 및 OpenAI 호환 API를 위한 듀얼 모드 지원, 다중 키 로테이션 및 구성 격리 기능을 제공합니다.
• PWA 지원: 데스크톱 또는 모바일 앱으로 설치 가능하며, 오프라인 셸 액세스 및 화면 속 화면(PiP) 모드를 지원합니다.
• 고급 파일 처리: 브라우저 측 오디오 전처리 및 코드베이스 구조 매핑을 위한 ZIP/폴더 업로드를 지원합니다.