agent-town은(는) 무엇을 하나요?
AI Town의 중국어 교육용 포크입니다. 학생들이 card.md를 업로드하여 디지털 아바타를 만들면, AI가 설정에 따라 2D 마을에서 생활합니다. 학생들이 이 저장소를 포크한 후 AI 프로그래밍 도우미를 사용하여 기능을 확장하도록 권장합니다.
시작하기
환경을 설정하고 실행하는 방법은 다음과 같습니다.
필수 조건
- Node.js 18+
- npm 또는 yarn
- AI 프로그래밍 도우미(예: Claude Code, Cursor, Codex)
설치
git clone https://github.com/yisiliu/agent-town.git
cd agent-town
npm install
환경 변수 설정
루트 디렉토리에 .env 파일을 생성하고 다음 값을 추가합니다:
OPENAI_API_KEY=your_openai_api_key
실행
npm run dev
사용 방법
public/cards/디렉토리에card.md파일을 업로드합니다.- 각
card.md파일에는 아바타의 이름, 성격, 직업, 취미 등이 포함됩니다. - 애플리케이션을 실행하면 AI가 설정에 따라 아바타를 제어합니다.
학생 과제
- 이 저장소를 개인 계정으로 포크합니다.
- 고유한 아바타를 가진
card.md파일을 만듭니다. - AI 프로그래밍 도우미를 사용하여 새로운 기능을 추가합니다(예: 새로운 상호작용, 사용자 지정 이벤트 등).
- 변경 사항을 커밋하고 포크에 푸시합니다.
확장 가이드
- 새로운 상호작용을 추가하려면
src/interactions/디렉토리를 수정합니다. - 마을 레이아웃을 변경하려면
src/world/디렉토리를 편집합니다. - 더 자세한 내용은 원본 AI Town 저장소를 참조하세요.
라이선스
MIT