중국어 | English | 일본어

다중 플랫폼 모델 연결, 확장 가능하며 다양한 출력 형식을 제공하는 대규모 언어 모델(LLM) 채팅 서비스 로봇 플러그인.

npm

github top language

QQ

doc

Ask DeepWiki

프로젝트 상태: 1.0 정식 버전 (느린 개발, v2 버전 준비 중)

📸 스크린샷

프리셋	Agent 모드 & 스트리밍 출력	이미지 렌더링 출력
preset	plugin	code

✨ 특징

• 🚀 높은 확장성 (LangChain 및 Koishi API 기반)
• 🎭 사용자 지정 대화 프리셋
• 🛡️ 속도 제한(Rate Limit) 및 블랙리스트 시스템
• 🎨 다중 형식 출력 (텍스트, 음성, 이미지, 혼합)
• 🧠 문맥 인식 및 장기 기억
• 🔀 세 가지 모드: 채팅(Chat), 브라우징(Browse), Agent
• 🔒 콘텐츠 검열 (Koishi 검열 서비스(https://censor.koishi.chat/)를 통해)

• Google (API)
• Bing (API / Web)
• DuckDuckGO (Lite)
• Tavily (API)

🎭 사전 설정(Presets)

1.0.0-alpha.10 버전부터는 더욱 커스터마이징 가능한 사전 설정을 사용합니다. 새로운 페르소나 사전 설정은 yaml을 구성 파일로 사용합니다.

기본적으로 포함된 페르소나 파일을 보려면 여기를 클릭하세요: catgirl.yml

저희의 기본 사전 설정 폴더 경로는 현재 플러그인을 실행하는 koishi 디렉토리 경로+/data/chathub/presets 입니다.

모든 사전 설정 파일은 위의 폴더에서 로드됩니다. 따라서 이 폴더에 자유롭게 사전 설정 파일을 추가하고 편집한 후, 명령어를 사용하여 페르소나를 전환할 수 있습니다.

더 자세히 알고 싶다면 이 문서를 참고하세요.

🔧 Fork & Develop

임의 Koishi 템플릿 프로젝트에서 다음 명령어를 실행하여 ChatLuna를 클론하세요:

# yarn
yarn clone ChatLunaLab/chatluna
# npm
...

위의 ChatLunaLab/chatluna를 직접 Fork한 프로젝트 주소로 대체할 수 있습니다.

템플릿 프로젝트 루트 디렉토리의 tsconfig.json 파일을 편집하여 compilerOptions.paths에 ChatLuna 프로젝트 경로를 추가하세요.

{
  "extends": "./tsconfig.base",
  "compilerOptions": {
...

프로젝트 자체가 비교적 복잡하므로, 초기 사용 시에는 반드시 빌드해야 합니다.

# yarn
yarn workspace @root/chatluna-koishi build
# npm
...

완료입니다! 이제 루트 프로젝트에서 yarn dev 또는 npm run dev를 사용하여 템플릿 프로젝트를 시작하고 ChatLuna를 이차 개발할 수 있습니다.

Koishi가 모듈 Hot Module Replacement(HMR)을 지원하지만, 본 프로젝트는 완전히 호환되지 않을 수 있습니다.

만약 HMR로 본 프로젝트를 이차 개발하는 과정에서 버그가 발생하면, Issue에 제기하고 위의 단계에 따라 프로젝트를 재빌드한 후 Koishi를 재시작하여 복구를 시도해 주세요.

🆘 도움말(Help)

Current ChatLuna 프로젝트 팀의 역량은 매우 부족하여 다음 목표들을 완료할 여력이 없습니다:

• Web UI
• Http Server
• Project Documentation

Pull Request를 제출하거나 토론에 참여하는 것을 환영합니다. 여러분의 기여를 진심으로 환영합니다!

👥 기여자 명단

📢 사용 안내

본 프로젝트는 ChatLunaLab에서 개발했습니다.

ChatLuna(이하 본 프로젝트)는 대규모 언어 모델(LLM) 기반의 대화 로봇 프레임워크입니다. 저희는 오픈소스 커뮤니티와 협력하여 대규모 모델 기술 발전을 추진하는 데 전념하고 있습니다. 개발자 및 다른 사용자들에게 본 프로젝트(및 커뮤니티가 추진하는 본 프로젝트 기반의 기타 파생 제품)의 프레임워크, 코드 및 관련 파생물을 국가나 사회에 해를 끼칠 수 있는 어떠한 목적이나 안전 평가 및 신고 절차를 거치지 않은 서비스에 사용하지 않도록 오픈소스 프로토콜을 준수할 것을 강력히 촉구합니다.

본 프로젝트는 생성형 인공지능 서비스를 직접 제공하지 않으므로, 사용자는 생산형 인공지능 서비스를 제공하는 조직이나 개인으로부터 사용하는 알고리즘 API를 직접 확보해야 합니다.

만약 본 프로젝트를 사용한다면, 현지 지역의 법률 및 규정을 준수하고 해당 지역에서 사용할 수 있는 생산형 인공지능 서비스 알고리즘을 사용해 주십시오.

본 프로젝트는 알고리즘 생성 결과에 대해 책임을 지지 않으며, 모든 결과와 작업은 사용자 본인이 책임져야 합니다.

본 프로젝트의 관련 정보 저장소는 사용자가 직접 출처를 구성해야 하며, 프로젝트 자체는 직접적인 정보 저장을 제공하지 않습니다.

본 프로젝트는 사용자가 야기하는 데이터 보안, 여론 위험 또는 모델이 오도되거나(misguided), 남용되거나(abused), 전파되거나(spread), 부적절하게 이용함으로써 발생하는 어떠한 위험과 책임도 지지 않습니다.

🙏 감사

Koishi - 크로스 플랫폼, 확장 가능하며 고성능의 NodeJS 채팅 로봇 프레임워크.

AstrBot - 원스톱 에이전틱(Agentic) 개인 및 그룹 채팅 비서 Python 프레임워크, 다중 플랫폼 배포 로봇.

본 프로젝트를 작성할 때 다른 오픈소스 프로젝트들도 참고했으며, 특히 다음 프로젝트에 감사드립니다:

koishi-plugin-openai

chathub