@quantumai/quantum-cli-core/README.md

Quantum CLI Core - Multi-LLM Collaboration System

# 🚀 Quantum CLI - 멀티-LLM 협업 시스템

[![npm version](https://badge.fury.io/js/@quantumai%2Fquantum-cli.svg)](https://badge.fury.io/js/@quantumai%2Fquantum-cli)
[![Downloads](https://img.shields.io/npm/dm/@quantumai/quantum-cli.svg)](https://www.npmjs.com/package/@quantumai/quantum-cli)
[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

**전 세계 최초 멀티-LLM 협업 CLI** - Gemini, GPT-4, Claude가 협력하여 더 정확하고 신뢰할 수 있는 AI 어시스턴트를 제공합니다.

## ✨ 주요 특징

### 🤝 멀티-LLM 협업
- **듀얼 검증**: 불확실한 답변을 자동으로 다른 모델로 검증
- **모델 비교**: 여러 모델의 응답을 동시에 비교
- **스마트 라우팅**: 작업 유형에 따라 최적 모델 자동 선택
- **신뢰도 점수**: 각 응답의 신뢰도를 실시간으로 표시

### 🎯 고급 기능
- **1M+ 토큰 컨텍스트**: 대규모 코드베이스 전체 분석
- **멀티모달**: 이미지, PDF, 문서 처리
- **실시간 협업**: 여러 AI 모델이 동시에 작업
- **비용 최적화**: 작업별 최적 모델 선택으로 비용 절약

## 🚀 빠른 설치

### npm으로 설치 (권장)

```bash
# 전역 설치
npm install -g @quantumai/quantum-cli

# 바로 사용
quantum --help
```

### 일회성 실행

```bash
# 설치 없이 바로 실행
npx @quantumai/quantum-cli

# 또는 GitHub에서 직접
npx github:quantumai/quantum-cli
```

## 🔧 설정

### 1. 기본 설정

```bash
# 첫 실행 시 자동 설정 가이드
quantum

# 수동 설정
quantum config
```

### 2. API 키 설정

#### Gemini API (무료 100회/일)
```bash
export GEMINI_API_KEY="your-gemini-key"
# https://aistudio.google.com/apikey 에서 발급
```

#### OpenAI API (GPT-4)
```bash
export OPENAI_API_KEY="your-openai-key"
# https://platform.openai.com/account/api-keys 에서 발급
```

#### Anthropic API (Claude)
```bash
export ANTHROPIC_API_KEY="your-anthropic-key"
# https://console.anthropic.com/ 에서 발급
```

#### Vertex AI (Google Cloud)
```bash
export GOOGLE_API_KEY="your-vertex-key"
export GOOGLE_GENAI_USE_VERTEXAI=true
# https://cloud.google.com/vertex-ai 에서 발급
```

## 🎮 사용법

### 기본 사용

```bash
# 대화형 모드
quantum

# 직접 질문
quantum "Hello, Quantum!"

# 파일과 함께 질문
quantum "이 코드를 리뷰해주세요" < script.js
```

### 멀티-LLM 모드

```bash
# 듀얼 검증 (불확실한 답변 자동 검증)
quantum --verify "복잡한 코딩 문제를 해결해주세요"

# 다중 모델 비교
quantum --compare "어떤 방법이 더 좋을까요?"

# 신뢰도 점수 표시
quantum --explain-confidence "이 코드가 안전한가요?"
```

### 특정 모델 사용

```bash
# GPT-4 사용
quantum --model gpt-4o "OpenAI로 답변해주세요"

# Claude 사용  
quantum --model claude-3-sonnet "Anthropic으로 분석해주세요"

# Gemini 사용 (기본값)
quantum --model gemini-2.5-pro "Gemini로 생성해주세요"
```

### 고급 옵션

```bash
# 모든 파일 포함
quantum --all_files "프로젝트 전체를 분석해주세요"

# 자동 승인 모드
quantum --yolo "빠르게 작업해주세요"

# 디버그 모드
quantum --debug "문제를 찾아주세요"

# 샌드박스 모드
quantum --sandbox "안전하게 실행해주세요"
```

## 📊 사용 예제

### 1. 코드 리뷰 & 개선
```bash
# 단일 모델로 리뷰
quantum "이 React 컴포넌트를 리뷰해주세요" < Component.jsx

# 다중 모델 비교 리뷰
quantum --compare "이 알고리즘을 최적화해주세요" < algorithm.py

# 검증된 리팩토링
quantum --verify "이 코드를 안전하게 리팩토링해주세요" < legacy.js
```

### 2. 문서화 & 설명
```bash
# API 문서 생성
quantum "이 함수들의 API 문서를 작성해주세요" < api.ts

# 복잡한 코드 설명
quantum --explain-confidence "이 정규식을 자세히 설명해주세요: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/"
```

### 3. 버그 찾기 & 수정
```bash
# 버그 탐지
quantum --verify "이 코드에서 버그를 찾아주세요" < buggy.js

# 에러 디버깅
quantum "이 에러를 해결해주세요: TypeError: Cannot read property 'length' of undefined"
```

### 4. 새 프로젝트 생성
```bash
# React 앱 생성
quantum "TypeScript와 Tailwind CSS를 사용하는 Todo 앱을 만들어주세요"

# API 서버 생성
quantum --compare "Express.js와 FastAPI 중 어떤 것으로 REST API를 만들면 좋을까요?"
```

## 🌟 고급 기능

### 멀티-LLM 협업 시나리오

1. **불확실성 감지**: AI가 확신하지 못하는 답변을 자동으로 감지
2. **자동 검증**: 다른 모델로 답변을 자동 검증
3. **신뢰도 분석**: 각 모델의 응답 신뢰도를 수치로 표시
4. **최적 모델 라우팅**: 작업 유형별로 가장 적합한 모델 자동 선택

### 비용 최적화

- **작업별 최적화**: 간단한 작업은 경제적인 모델, 복잡한 작업은 고성능 모델
- **실시간 비용 추적**: API 사용량과 비용을 실시간으로 모니터링
- **예산 관리**: 월별 예산 설정 및 알림

## 🔗 추가 리소스

### 📚 문서
- [설치 가이드](./docs/installation.md)
- [설정 가이드](./docs/cli/configuration.md)
- [API 키 설정](./docs/api-keys-setup.md)
- [고급 사용법](./docs/cli/tutorials.md)

### 🛠️ 개발자
- [아키텍처 문서](./docs/architecture.md)
- [기여 가이드](./CONTRIBUTING.md)
- [API 문서](./docs/core/tools-api.md)

### 🤝 커뮤니티
- [GitHub Issues](https://github.com/quantumai/quantum-cli/issues)
- [토론 게시판](https://github.com/quantumai/quantum-cli/discussions)
- [기능 요청](https://github.com/quantumai/quantum-cli/issues/new?template=feature_request.md)

## 📈 상태 및 로드맵

### 현재 상태 (v0.2.2)
- ✅ **Phase 1**: 듀얼-LLM 협업 (Gemini + GPT-4/Claude)
- ✅ **Phase 2**: 불확실성 감지 및 자동 검증  
- ✅ **Phase 3**: 스마트 라우팅 및 비용 최적화
- 🚧 **Phase 4**: 3-모델 협업 및 고급 개인화 (진행 중)

### 다음 버전 (v0.3.0)
- 🔄 트리플-LLM 협업 (Gemini + GPT + Claude 동시 작업)
- 🎯 고급 개인화 및 학습 시스템
- 📊 실시간 성능 분석 대시보드
- 🔌 플러그인 시스템

## 🙏 기여하기

Quantum CLI는 오픈소스 프로젝트입니다. 기여를 환영합니다!

```bash
# 프로젝트 클론
git clone https://github.com/quantumai/quantum-cli.git
cd quantum-cli

# 의존성 설치
npm install

# 개발 모드 실행
npm run dev

# 테스트 실행
npm test
```

## 📄 라이선스

Apache License 2.0 - 자세한 내용은 [LICENSE](./LICENSE) 파일을 참조하세요.

## 🌟 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=quantumai/quantum-cli&type=Date)](https://star-history.com/#quantumai/quantum-cli&Date)

---

**Quantum CLI로 AI 개발의 새로운 차원을 경험해보세요!** ✨

```bash
npm install -g @quantumai/quantum-cli
quantum "Quantum CLI를 사용해 멀티-LLM의 힘을 경험해보세요!"
```