Upload: README.md

# LQ-KBERT-Base: Crypto Market Korean Sentiment & Action Signal Classifier

[LangQuant](https://langquant.com)에서 공개한 **한국어 금융 커뮤니티/뉴스 투자심리 분류 모델**입니다.
`klue/bert-base`를 백본으로 하고, 가상자산 관련 한국어 데이터셋 **10만 건 이상**을 전처리하여 파인튜닝했습니다.
모델은 문장 단위 입력(`≤200자`)에 대해 **투자 심리·행동·감정·확신도·관련성·유해성**을 동시에 예측합니다.

- [Github](https://github.com/LangQuant/LQ-KBERT-Base)
---
### 모델은 다음 항목을 예측합니다.

```json
{
"sentiment_strength": "strong_pos | weak_pos | neutral | weak_neg | strong_neg",
"action_signal": "buy | hold | sell | avoid | info_only | ask_info",
"emotions": ["greed","fear","confidence","doubt","anger","hope","sarcasm"],
"certainty": 0.0 ~ 1.0,
"relevance": 0.0 ~ 1.0,
"reasons": "라벨 근거를 요약한 한국어 1~2문장",
"toxicity": 0.0 ~ 1.0
}
```
---
## Labeling Guidelines

### Sentiment Strength
- **strong_pos**: 급등 확신, `"가즈아"`, `"무조건 간다"`.
- **weak_pos**: 조심스러운 낙관, `"반등 가능"`, `"괜찮을 듯"`.
- **neutral**: 단순 정보/공지/잡담.
- **weak_neg**: 완곡한 부정, `"조정 올 듯"`, `"관망"`.
- **strong_neg**: 폭락·패닉, `"나락"`, `"망함"`, `"해킹/제재"`.

### Action Signal
- **buy**: 매수/진입 지시, `"지금 산다"`, `"롱"`.
- **hold**: 보유 유지/관망, `"존버"`, `"유지"`.
- **sell**: 매도/청산, `"익절"`, `"손절"`, `"정리"`.
- **avoid**: 회피/위험 경고, `"가지마"`, `"스캠"`, `"위험"`.
- **info_only**: 단순 정보 전달 (뉴스/공지).
- **ask_info**: 질문/탐색, `"들어가도 돼?"`, `"왜 떨어져?"`.

### Emotions (다중 선택)
- **greed** 탐욕
- **fear** 두려움
- **confidence** 확신
- **doubt** 의심
- **anger** 분노
- **hope** 희망
- **sarcasm** 풍자

### Certainty
- **0.2~0.4**: 질문·탐색·밈 (낮음)
- **0.4~0.6**: 완곡한 의견 (중간)
- **0.6~0.8**: 수치·근거·공식성 (높음)
- **0.8~1.0**: 강한 단정·지시 (매우 높음)

### Relevance
- **0.7~1.0**: 직접적인 투자/시장 관련
- **0.4~0.7**: 간접 관련 (업계/인물/기술)
- **0.0~0.3**: 무관/잡담/밈

### Toxicity
- 욕설·모욕·비하 강도에 따라 **0~1**.
- 투자 의미와는 별도로 독립적으로 평가.

---

## Sentiment Strength vs Action Signal

- **Sentiment Strength**
- 투자 심리의 강도 (긍정 ↔ 부정).
- 가격 전망의 톤에 집중.

- **Action Signal**
- 실제 투자 행동 의도/지시.
- 매수/매도/보유/회피/질문/정보.


---

### 예시

| 문장 | sentiment_strength | action_signal | 해석 |
|------|--------------------|---------------|------|
| "개떡상이여 " | strong_pos | buy | 강한 상승 확신 + 즉시 매수 의도 |
| "여기선 관망이 맞다" | weak_neg | hold | 부정적이지만 보유 유지 선택 |
| "들어가도 될까?" | weak_pos | ask_info | 조심스러운 낙관, 매수 탐색 질문 |
| "해킹 터짐, 비상. 접근 금지" | strong_neg | avoid | 강한 부정 + 회피 권고 |
| "업데이트 공지 나왔습니다" | neutral | info_only | 단순 정보 제공, 행동 없음 |

---
### Citation
```


@misc
{langquant2025lkbert,
title = {LQ-KBERT-Base: Crypto Market Korean Sentiment & Action Signal Classifier},
author = {LangQuant},
year = {2025},
url = {https://huggingface.co/langquant/LQ-Kbert-base}
}
```
---
### Disclaimer
```
이 모델은 학술 연구 및 실험용으로만 제공됩니다.
본 모델의 출력은 금융/투자 자문으로 간주될 수 없으며,
발생하는 모든 결과에 대해 LangQuant는 책임을 지지 않습니다.
```

README.md

@@ -1,3 +1,8 @@
----
-license: mit
----
+---
+license: mit
+language:
+- ko
+- en
+base_model:
+- klue/bert-base
+---