AnnenkovLabs/girl-agent

What it solves

AI 페르소나의 현실감 부족 문제를 해결합니다. 단순 시스템 프롬프트를 넘어 인간처럼 행동하는 텔레그램 기반 AI 동반자를 만들 수 있습니다. 상태 기반 행동 엔진을 통해 과도하게 정중하거나 언제나 이용 가능하고 반복적인 표현과 같은 "AI‑같은" 응답을 방지합니다.

How it works

단일 프롬프트에 의존하지 않고, 에이전트의 행동은 여러 상태 레이어로 구성됩니다:

• Presence & Sleep: 수면 주기와 응답 빈도 변화를 포함해 인간의 가용성을 시뮬레이션합니다.
• Daily Life: 업무, 공부, 여가 등 일정에 따라 접근성을 조절합니다.
• Relationship System: 관심, 신뢰, 동정, 짜증, 민망함 허용도라는 5가지 관계 지표를 추적하고, 친밀 단계 9단계를 진행합니다.
• Conflict System: 사용자가 스팸을 보내거나 경계를 넘으면 침묵 또는 철수를 트리거합니다.
• Memory: 중요한 사건을 장기 markdown 파일에 저장해 향후 회상에 활용합니다.
• Anti-AI Layer: markdown 포맷, 일반 문구("이해했습니다"), 이모지 문자열 등 전형적인 LLM 마커를 명시적으로 금지합니다.
• Userbot Mode: MTProto를 사용해 실제 텔레그램 계정으로 동작하며, 메시지를 읽고, 반응하고, 입력하고, 편집할 수 있습니다.
• Agenda: 이벤트에 행운을 기원하는 등 메시지를 능동적으로 계획해 독립적인 삶을 시뮬레이션합니다.

Who it’s for

텔레그램에서 매우 현실적이고 상태를 유지하는 AI 페르소나를 만들고자 하는 개발자와 애호가를 위한 프로젝트입니다. 전형적인 챗봇 패턴을 피할 수 있습니다.

Highlights

• State-driven behavior: 단순 시스템 프롬프트가 아니라 복잡한 카운터와 단계 시스템을 사용합니다.
• Longe-term memory: 중요한 사건을 지속적으로 저장해 수개월에 걸친 연속성을 유지합니다.
• Human-like interaction: 타이핑, 반응, 전략적 침묵을 시뮬레이션합니다.
• Proactive engagement: 에이전트가 자체 내부 아젠다에 따라 대화를 시작할 수 있습니다.
• Deployment flexibility: 로컬 설치, Docker, 네이티브 Rust 데스크톱 클라이언트를 지원합니다.