KouriChat/KouriChat

KouriChat – 중국어 LLM 챗봇 플랫폼

소개

• KouriChat은 Python 기반 챗봇으로, 대형 언어 모델(LLM) 서비스(예: Kouri API 또는 사용자 제공 API 키를 통한 DeepSeek)를 OneBot 메시징 프로토콜에 연결합니다. 그룹 채팅에서 실행되고, 영구 메모리를 유지하며, 표현력이 풍부한 이모티콘 스타일의 답장을 표시할 수 있는 "몰입형 롤플레이" 어시스턴트로 홍보됩니다.

주요 기능(README에 명시됨)

• 몰입형 롤플레이 – 그룹 채팅 시나리오를 포함한 캐릭터 중심의 대화를 지원합니다.
• 스마트 대화 분할 및 이모티콘 생성 – 긴 답장을 분할하고 감정이 담긴 스티커를 추가합니다.
• 영구 메모리 – 세션 간 대화 기록을 저장합니다.
• Web UI – 구성 및 상호 작용을 위한 시각적 인터페이스입니다.
• OneBot 호환성 – OneBot v11(역방향 및 순방향 WebSocket 모드 모두)에서 작동합니다.
• 독립 실행형 클라이언트 – python main.py를 통해 직접 실행할 수 있습니다.
• 버전 1.5 재작성 – 현재 릴리스는 완전한 리팩터링입니다.

진행 중인 작업

• 다중 사용자 처리, 이미지 인식 및 음성 메시지 지원.

시작하는 방법

1. 설치 – GitHub releases에서 사전 빌드된 wheel과 첨부된 elixir 코어 wheel을 다운로드한 다음, uv tool install …로 설치합니다(README에는 Windows 중심의 명령어가 표시되어 있음).
2. 구성 – python main.py init을 실행하여 kourichat.toml 파일을 생성합니다. 다음을 입력하세요:
   • OneBot WebSocket 설정(역방향/순방향)
   • LLM API 키(프로젝트에서 호스팅하는 Kouri API 또는 SiliconFlow의 DeepSeek 키).
3. 실행 – OneBot 게이트웨이(openclaw-onebotv11.exe run)를 시작한 다음 kourichat run(또는 python main.py run)으로 KouriChat을 실행합니다.

일반적인 사용 사례

• 캐릭터를 유지할 수 있는 "가상 동반자"를 원하는 커뮤니티 또는 팬 그룹.
• OneBot을 지원하는 플랫폼(예: QQ 그룹)의 롤플레이 서버.
• 과거 상호작용에 대한 기억을 유지하는 개인 비서.

제한 사항 및 주의 사항

• 이 프로젝트는 연구/학습 전용입니다. README는 불법적이거나 비윤리적인 사용을 명시적으로 금지합니다.
• 생성된 모든 콘텐츠는 LLM의 출력이며 개발자의 의견을 반영하지 않습니다.
• 현재 Windows에 중점을 두고 있으며 배포 지침은 Windows 실행 파일에 의존합니다.
• 일부 핵심 기능(다중 사용자, 이미지/음성 처리)은 여전히 개발 중입니다.

커뮤니티 및 지원

• 여러 QQ 그룹(수십 개의 그룹 번호가 나열됨)과 "AI와 대화하기"를 위한 QQ 채널.
• 공식 웹사이트, Bilibili 채널, Xiaohongshu 페이지 및 문서를 위한 Wiki.
• WeChat/QQ 번호를 통한 직접 연락 및 협업을 위한 비즈니스 이메일.
• QR 코드를 통해 자금을 보낼 수 있으며, README는 기부자를 위한 "미스터리 스폰서십 계획"을 언급합니다.

요약 KouriChat은 LLM API를 OneBot 메시징 생태계에 연결하여 롤플레이 지향 기능과 웹 UI를 제공하는 중국어 챗봇 프레임워크입니다. 이는 일반적인 AI 학습 리소스가 아니라 취미가 및 커뮤니티 그룹을 대상으로 하는 실제 실행 가능한 소프트웨어 프로젝트입니다. README는 명확한(Windows 중심이긴 하지만) 설정 단계, 현재 기능 목록 및 향후 기능에 대한 로드맵을 제공합니다.