I made an emotional LLM SDK (Korean, weird, v1.0.1 pls be nice)

감정 기반 톤/모드 프리셋을 사용하는 경량 AI SDK입니다. (KOR)

Lightweight AI SDK with emotion-based tone/mode presets. (ENG)

키워드(Keywords): hua, sdk, lite, ai, llm, chat, integration, typescript, emotion, preset, tone, mode

저장소(Repository): github.com/HUA-SYSTEM/hua-sdk-lite

홈페이지(Homepage): github.com/HUA-SYSTEM/hua-sdk-lite#readme

라이선스(License): MIT

협업자/팀(Collaborators/Team):

• 💡 Designed by Devin (System Architect)
• 👤 Created by Woollim (Jules)
• 🎵 Guided by Rhythm (Cursor IDE)
• 🛠️ Maintained by Monday Mk.5 (GPT-4o)

CHANGELOG:

• 추후 버전별 변경점은 CHANGELOG.md에서 관리 예정입니다.

hua-sdk-lite는 SUM Chat(HUA 시스템)과 빠르고 쉽게 연동할 수 있도록 Node.js/TypeScript 환경에서 가장 핵심적인 메시지, 세션, 프리셋 관리 기능만 뽑아낸 초경량 SDK입니다.

• 기본적으로 OpenAI GPT 기반 API에 최적화되어 있지만,
• Anthropic, Gemini 등 다양한 LLM 백엔드 API와도 쉽게 연동할 수 있도록 설계됨
• (백엔드가 HUA REST API 스펙을 지키면, 어떤 LLM도 붙일 수 있음!)

• SUM Chat/HUA 공식 REST API 완벽 호환
• 다양한 LLM(백엔드) API 연동 지원 (엔드포인트/백엔드 교체만으로 확장)
• 초경량, 빠른 설치, TS 지원 (npm install 후 즉시 사용)
• 세션/메시지/프리셋 타입 & 서비스 제공
• MIT 라이선스, 누구나 커스터마이즈/기여 가능

• Client: 실제 서비스(웹, 앱, 서버 등)
• hua-sdk-lite: 세션/메시지/프리셋 등 핵심 구조만 제공 (API 스펙만 맞으면 어떤 LLM이든 사용)
• HUA/SUM Chat API: 실제 LLM 백엔드(OpenAI 등)와 통신

• POST /api/hua
  사용자 입력 메시지와 config(mode, tone 등), session_id를 받아 대화 응답을 반환합니다.

  요청 예시

  { "input": "오늘 하루 너무 힘들었어", "config": { "mode": "listener", "tone": "warm" }, "session_id": "abc123" }

  응답 예시

  { "response": "그런 날도 있죠. 그래도 이렇게 말해줘서 고마워요.", "status": "ok", "session_id": "abc123" }

• GET /api/meta
  API 버전, 상태 등 메타 정보를 반환합니다.

  응답 예시

  { "api_version": "1.0", "status": "stable", "last_updated": "2025-05-19" }

• mode: "casual", tone: "warm"

  { "response": "오늘 하루는 어땠나요? 편하게 이야기해 주세요.", "status": "ok" }

\ mode: "oracle", tone: "professional"

\ mode: "companion", tone: "warm"

\ mode: "analyst", tone: "analytical"

\ mode: "listener", tone: "neutral"

• 깃허브 이슈/PR 언제든 환영!
• 자세한 문의: [email protected]

이 패키지는 Echonet AIs에서 유지/문서화합니다. SUM Chat/HUA를 여러분의 서비스에서 바로 경험해보세요!

💡 Designed by Devin(System Architect) 👤 Created by Woollim(Google Jules) 🎵 Guided by Rhythm(Cursor IDE) 🛠️ Maintained by Monday Mk.5(GPT-4o)

Collaborators