ChatLunaLab/chatluna

어떤 프로젝트인가요?

핵심 기능

• 01OpenAI, Gemini, Claude, DeepSeek, Qwen, Ollama 등을 비롯한 다양한 LLM 제공자와 연결합니다.
• 02채팅, 브라우징, 에이전트 모드를 제공합니다.
• 03YAML 프리셋 파일로 페르소나를 설정합니다.
• 04텍스트, 음성, 렌더링된 이미지 또는 혼합 형식으로 답변을 출력합니다.
• 05스트리밍 응답과 멀티모달 모델의 이미지 입력을 지원합니다.
• 06요청 제한, 차단 목록, MCP 클라이언트를 포함합니다.

활용 사례

• Koishi로 운영하는 QQ 그룹 채팅에 LLM 어시스턴트를 추가합니다.
• 봇이 실시간 웹 검색 결과를 바탕으로 질문에 답하도록 합니다.
• 프리셋 파일을 사용해 채팅 그룹마다 다른 페르소나를 설정합니다.
• LangChain과 Koishi를 기반으로 새 모델 어댑터를 프로토타이핑합니다.

빠른 시작

1. 1

   Koishi 프로젝트 내에 플러그인을 설치합니다(배포 가이드 참고).

2. 2

   yarn으로 Koishi 템플릿 프로젝트에 ChatLuna를 클론합니다.

   yarn clone ChatLunaLab/chatluna
3. 3

   처음 사용하기 전에 프로젝트를 한 번 빌드합니다.

   yarn workspace @root/chatluna-koishi build
4. 4

   템플릿 프로젝트를 개발 모드로 시작합니다.

   yarn dev

사용 전 알아둘 점

• !프로젝트 개발은 느리게 진행 중이며 v2 릴리스를 준비하고 있습니다.
• !Claude와 같은 모델 제공업체를 사용하려면 본인의 API 키가 필요하며, 일부는 유료입니다.
• !AGPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 파생 저작물에도 적용됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

chatluna은(는) 무엇인가요?

QQ 및 기타 채팅 봇에 LLM 대화 기능을 추가하는 Koishi 봇 플러그인으로, 다양한 모델 제공자와 프리셋, 여러 출력 형식을 지원합니다. ChatLuna는 대규모 언어 모델을 기반으로 봇이 대화할 수 있게 해주는 Koishi 챗봇 프레임워크용 플러그인입니다. OpenAI, Azure OpenAI, Google Gemini, Claude, DeepSeek, Qwen, Doubao, Zhipu, Spark, Wenxin, Hunyuan, Ollama, RWKV 등 다양한 제공자와 연결할 수 있으며, 설정 파일을 수정하지 않고 Koishi에서 바로 설치할 수 있습니다.

chatluna은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

chatluna은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

chatluna은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. chatluna의 마지막 커밋은 2026년 10월 28일입니다.

chatluna은(는) 어디에 사용할 수 있나요?

Koishi로 운영하는 QQ 그룹 채팅에 LLM 어시스턴트를 추가합니다. 봇이 실시간 웹 검색 결과를 바탕으로 질문에 답하도록 합니다. 프리셋 파일을 사용해 채팅 그룹마다 다른 페르소나를 설정합니다. LangChain과 Koishi를 기반으로 새 모델 어댑터를 프로토타이핑합니다.

chatluna는 어떻게 설치하나요?

Koishi 프로젝트 내에 플러그인을 설치합니다(배포 가이드 참고). yarn으로 Koishi 템플릿 프로젝트에 ChatLuna를 클론합니다.: yarn clone ChatLunaLab/chatluna 처음 사용하기 전에 프로젝트를 한 번 빌드합니다.: yarn workspace @root/chatluna-koishi build 템플릿 프로젝트를 개발 모드로 시작합니다.: yarn dev

chatluna은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ChatLunaLab/chatluna