📊 톡리포트 — KakaoTalk Chat Analyzer

카카오톡 대화 파일(.txt)을 업로드하면 기간 및 사용자별 메시지를 분석하고 시각화를 제공하는 웹 서비스

---

💬 소개

톡리포트(Talk Report) 는
카카오톡에서 내보낸 대화 텍스트 파일(.txt) 을 기반으로 기간별·사용자별 대화 패턴을 분석해주는 웹 기반 분석 도구입니다.

• 기간별 메시지 수 분석
• 사용자별 메시지 수 분석
• 시간대별 메시지 수 분석
• 사용자별 단어 분석 (추가 예정)

---

🛠️ 주요 기능

📁 1. 파일 업로드

• 카카오톡 “대화 내보내기(.txt)” 파일 업로드

📅 2. 분석 기간 선택

• 시작 / 종료 날짜 및 시간 선택

📊 3. 분석 결과 제공

• 전체 메시지 수
• 사용자별 메시지 수
• 사용자별 메시지 수 순위표
• 시간대별 메시지 그래프
• (예정) 사용자별 단어 빈도

---

2025.12.19 update

• 사용자별 메시지 수 그래프를 내림차순으로 정렬하여 시각화 하도록 수정하였습니다.
• 사용자별 메시지 수 순위를 표로 나타내도록 추가하였습니다.

---

2025.12.29 update

• 파일 하나 선택 또는 폴더 전체 선택이 가능하도록 수정하였습니다.
• pc톡에서의 내보내기 포맷과 모바일에서의 내보내기 포맷이 달라 모두 파싱할 수 있도록 수정하였습니다.
• 전체적인 UI를 개선하였습니다.

---

🆕 2026.03.24 update

• 대용량 txt 파일 분석 시 속도를 개선하기 위해 파일 전체를 하나의 문자열로 합치지 않고, 파일별로 파싱하면서 바로 집계하도록 최적화하였습니다.
• 파서가 메시지 리스트를 한 번에 생성하지 않고 순차적으로 처리하도록 수정하여 메모리 사용량을 줄였습니다.
• 시작일/종료일 미입력 또는 잘못된 날짜 입력에 대한 예외 처리를 추가하였습니다.
• 총 메시지 수, 사용자별 메시지 수, 그래프 축 및 hover 값에 천 단위 구분기호(,)가 표시되도록 개선하였습니다.

🖼️ 화면 예시

📝 사용 방법 요약

파일 업로드 → 기간 선택 → 분석하기 → 그래프 확인

---

📂 프로젝트 구조

project/
├─ app/
│ ├─ main.py # FastAPI 서버
│ ├─ parser.py # 카카오톡 로그 파서
│ ├─ analysis.py # 통계 분석
│ └─ static/
│ ├─ index.html # UI 페이지
│ └─ script.js # Plotly 그래프 및 프론트 JS
├─ assets/
│ └─ logo.png # 서비스 로고
│ └─ example.png # 동작 화면
├─ requirements.txt
└─ README.md

⚙️ 설치 및 실행 방법

✔️ 1. Repository 클론

git clone https://github.com/your/repo.git
cd repo

✔️ 2. 패키지 설치

pip install -r requirements.txt

✔️ 3. FastAPI 서버 실행

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

✔️ 4. 접속

브라우저에서 아래 주소로 접속 :

http://localhost:8000