readme.txt 작업중

.gitignore

@@ -3,6 +3,7 @@ __pycache__/
 *.py[cod]
 *$py.class
 
+
 # C extensions
 *.so
 

README.txt

@@ -0,0 +1,40 @@
+# 🧠 자율 성장형 AI 에이전트 소셜 시뮬레이션
+> 감정, 기억, 가치관을 가진 NPC들과 함께 살아가는 가상 세계
+
+![Python](https://img.shields.io/badge/Python-3.10-blue?logo=python)
+![Flask](https://img.shields.io/badge/Flask-Web_Framework-black?logo=flask)
+![License](https://img.shields.io/badge/License-MIT-green)
+<br>
+<br>
+## 📝 프로젝트 소개
+이 프로젝트는 단순히 정해진 대사를 반복하는 게임 NPC를 넘어, 자체적인 감정, 기억, 성격, 관계를 바탕으로 상호작용하며<br>
+<strong>스스로 판단하고 성장하는 가상 인간(AI Agent)</strong>을 구현하는 AI 시뮬레이션입니다.
+
+- **플랫폼**: 웹 기반 (Python + Flask)
+- **핵심 기술**: LLM (Gemini), Sentence-TransFormers, FAISS
+- **주요 기능**: 자율 행동, 기억 기반 대화, 가치관 형성, 성격/관계 변화, 플레이어 개입 등
+<br>
+
+## 🚀 주요 기능 및 시스템
+### 🧩 동적 멀티턴 대화 시스템
+- 단답형 문답을 넘어, NPC의 감정, 기억, 관계를 활용한 깊이 있는 대화
+
+### 🧠 자율 에이전트 아키텍처
+- LLM 기반 Reasoner/Planner가 장기 목표와 행동 계획을 자율적으로 생성
+
+### 🔍 고차원 자아 성찰 기능
+- NPC는 관계를 재정의하고 스스로의 가치관을 점진적으로 형성
+
+### 🧭 상황 인지 기반 사회적 행동
+- "도움 주기" 등의 사회적 행동이 메모리와 관계에 영향을 줌
+
+### 🧠 RAG 기반 기억 시스템
+- FAISS를 통한 의미적 기억 검색 및 활용 (Sentence-Transformers + LLM)
+
+### 🕹️ 플레이어 개입 시스템
+- 관계 설정, 이벤트 유도 등으로 NPC 세계에 실시간 개입 가능
+<br>
+
+## 🖼️ 시각화: 월드 관찰자 대시보드
+NPC들의 내면 상태와 관계 변화를 실시간으로 시각화하는 웹 기반 대시보드입니다.
+![Dashboard Example](./npc_social_network/static/dashboard_example.png)