Windows · 로컬 전용 · Xside와 별개 제품

Kakao Agent

AI가 침입할 수 없는 카카오톡.
나의 대화를 다른 에이전트가 쓸 수 있도록,
카카오톡에 AI를 붙이세요.

외부 AI가 카톡 안으로 들어가 몰래 읽는 제품이 아닙니다. 당신이 내보낸 대화를 로컬 DB에 쌓고, 다른 에이전트·도구·API가 127.0.0.1에서만 읽게 하는 허브입니다.

저장소 보기 로컬 read API

침투가 아닙니다.

카카오톡 클라이언트·암호화 edb를 뚫지 않습니다. Save 창으로 다른 작업을 가로채는 UI export도 기본 차단입니다.

부착입니다.

inbox에 넣은 내보내기 → SQLite 누적 → 일정 후보 → 로컬 API. 승인·경로·데이터는 전부 당신 PC에 남습니다.

설치 · 본선 흐름

방해 없는 백그라운드가 본선입니다. 창 포커스 없이 inbox만 보면 됩니다.

설치

git clone https://github.com/cdsassj00/kakao-agent
cd kakao-agent
py -3.13 -m pip install -r requirements.txt

inbox에 대화 넣기

.\kakao_agent.cmd inbox-path
# 카톡 채팅방 → Ctrl+S 저장 → 위 폴더에 txt 복사
.\kakao_agent.cmd inbox-sync
.\kakao_agent.cmd schedule

패널 · 다른 에이전트 연결

.\kakao_agent.cmd ui
# http://127.0.0.1:8765  ·  /api/v1/health

다른 에이전트용 로컬 API

`ui`를 켜면 127.0.0.1에 read-only JSON이 열립니다. 클라우드로 나가지 않습니다. OpenAPI는 /api/v1/openapi.json.

GET  /api/v1/health
GET  /api/v1/rooms
GET  /api/v1/rooms/{slug}/messages?limit=50&before_id=
GET  /api/v1/schedule?limit=30&room=
GET  /api/v1/stats
GET  /api/v1/openapi.json

Cursor·Claude·자체 스크립트가 같은 PC에서만 호출하면 됩니다. 바인딩은 localhost 고정.

한계 · 프라이버시

로컬 *.edb 대화 본문은 SQLCipher 암호화 — 키 없이 silent 본문 수집 불가
UI Ctrl+S 자동 내보내기는 기본 OFF (--allow-ui-export 옵트인)
일정 후보는 규칙 기반(LLM 아님). 사람이 확인해야 함
대화 원문·DB·키는 Git에 올리지 마세요

Xside가 아닙니다

Xside는 Excel COM을 AI에 넣는 Windows 앱입니다. Kakao Agent는 카카오톡 대화를 로컬로 모아 다른 에이전트에 열어 주는 별도 프로젝트입니다. 자산·카피·바이너리를 공유하지 않습니다.