Skip to content

Repository files navigation

K-Chat

개인의 데이터 주권을 지키는 오픈소스 한국 AI 어시스턴트

License: MIT


🎯 K-Chat이란?

K-Chat은 한국 AI 모델만 사용하는 AI 채팅 어시스턴트입니다.

  • 🔒 데이터 주권: 모든 대화는 당신의 기기에만 저장됩니다
  • 🇰🇷 한국 AI: Upstage Solar, Motif 등 국산 모델 사용
  • 📖 오픈소스: MIT 라이선스, 소스코드 100% 공개
  • 👨‍👩‍👧‍👦 쉬운 설치: 클론 → 설치 → 실행, 3단계로 끝

🚀 빠른 시작

사전 준비

# pnpm 설치 (없는 경우)
npm install -g pnpm

설치 및 실행

# 1. 소스코드 클론
git clone https://github.com/youngbin0417/k-chat.git
cd k-chat

# 2. 환경변수 설정
cp .env.example .env.local

# 3. 의존성 설치
pnpm install

# 4. 데이터베이스 초기화
cd packages/app-web
npx prisma migrate dev --name init
cd ../..

# 5. 실행
pnpm dev:web

브라우저에서 http://localhost:3000에 접속하세요.

API 키 설정

  1. 설정 페이지(/settings)에서 API 키를 입력합니다.
  2. 하나 이상의 AI 모델 API 키가 필요합니다.
모델 API 키 발급
Upstage Solar console.upstage.ai
Motif chat.motiftech.io

📁 프로젝트 구조

k-chat/
├── packages/
│   ├── shared/          # 공통 비즈니스 로직 (웹/앱 공유)
│   │   ├── src/api/     # AI 모델 API 클라이언트
│   │   ├── src/memory/  # 메모리 매니저
│   │   ├── src/router/  # 모델 라우팅 엔진
│   │   ├── src/types/   # 공통 타입
│   │   └── src/repositories/  # Repository 인터페이스
│   │
│   └── app-web/         # Next.js 웹 앱
│       ├── src/app/     # 페이지 (App Router)
│       ├── src/components/  # React 컴포넌트
│       ├── src/hooks/   # React Hooks
│       ├── src/store/   # 상태관리 (Zustand)
│       ├── src/lib/     # DB, Repository 구현체
│       └── prisma/      # SQLite 스키마
│
├── package.json         # 모노레포 루트
├── turbo.json           # Turborepo 설정
└── pnpm-workspace.yaml  # 워크스페이스 설정

🔧 지원 AI 모델

모델 제공자 특장점
Solar Pro 3 Upstage 한국어 최적화, 문서 OCR
Motif 12.7B Reasoning Motif Technologies 한국어 대화 및 심층 추론 특화
HyperCLOVA X 네이버 Vision 지원, 이미지 인식
EXAONE 3.0 LG AI연구원 오픈소스 한국어 모델

📜 라이선스

MIT License - 자유롭게 사용, 수정, 배포 가능합니다.


🤝 기여

버그 제보, 기능 제안, Pull Request 모두 환영합니다!


Made with ❤️ in Korea

About

한국 ai 라우팅 서비스

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages