a16z-infra/ai-town

어떤 프로젝트인가요?

핵심 기능

• 01AI 캐릭터들이 서로 대화하고 어울리는 가상 마을을 시뮬레이션합니다.
• 02Convex를 기반으로 공유 상태, 트랜잭션, 시뮬레이션 엔진을 제공합니다.
• 03Ollama를 통한 로컬 추론과 Together.ai 및 OpenAI 호환 API를 지원합니다.
• 04캐릭터, 스프라이트 시트, Tiled로 편집하는 맵을 맞춤 설정할 수 있습니다.
• 05Replicate를 통한 배경 음악 생성을 선택적으로 지원합니다.
• 06로컬이나 Docker Compose에서 실행하거나 Convex 클라우드, Fly.io, Vercel에 배포할 수 있습니다.

활용 사례

• 가상 세계에서 생성형 에이전트가 사회적 행동을 어떻게 시뮬레이션하는지 학습하기.
• LLM 기반 캐릭터를 사용하는 멀티 에이전트 시뮬레이션이나 소규모 멀티플레이어 게임을 프로토타이핑하기.
• 나만의 캐릭터, 이야기, 맵으로 가상 마을을 만들기.
• 독립된 환경에서 Ollama를 통해 로컬 LLM을 실험하기.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/a16z-infra/ai-town.git
2. 2

   프로젝트 폴더로 이동해 종속성을 설치합니다

   cd ai-town && npm install
3. 3

   앱을 로컬에서 시작합니다(메시지가 표시되면 Convex에 로그인하세요)

   npm run dev
4. 4

   브라우저에서 http://localhost:5173 을 엽니다

사용 전 알아둘 점

• !기본 설정에서 AI 채팅을 사용하려면 무료 Convex 계정과 llama3가 설치된 로컬 Ollama 환경이 필요합니다.
• !OpenAI 또는 Together.ai와 같은 클라우드 LLM 옵션을 사용하려면 유료 API 키가 필요합니다.
• !Windows 사용자는 WSL2와 Ubuntu 방식의 환경이 필요합니다.

토픽

자주 묻는 질문

ai-town은(는) 무엇인가요?

Convex 기반의 가상 마을 AI Town을 배포하고 맞춤 설정할 수 있는 MIT 라이선스 스타터 키트입니다. AI Town은 AI 캐릭터들이 생활하고 대화하며 어울리는 가상 마을입니다. Generative Agents 연구 논문에서 영감을 받은 이 프로젝트는 자신만의 버전을 만들 수 있도록 배포 가능한 스타터 키트를 제공합니다. TypeScript로 작성되었으며 확장할 수 있도록 설계되었습니다. Convex 백엔드는 전역 공유 상태, 트랜잭션, 시뮬레이션 엔진을 제공합니다.

ai-town은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ai-town은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ai-town은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. ai-town의 마지막 커밋은 2026년 8월 26일입니다.

ai-town은(는) 어디에 사용할 수 있나요?

가상 세계에서 생성형 에이전트가 사회적 행동을 어떻게 시뮬레이션하는지 학습하기. LLM 기반 캐릭터를 사용하는 멀티 에이전트 시뮬레이션이나 소규모 멀티플레이어 게임을 프로토타이핑하기. 나만의 캐릭터, 이야기, 맵으로 가상 마을을 만들기. 독립된 환경에서 Ollama를 통해 로컬 LLM을 실험하기.

ai-town는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/a16z-infra/ai-town.git 프로젝트 폴더로 이동해 종속성을 설치합니다: cd ai-town && npm install 앱을 로컬에서 시작합니다(메시지가 표시되면 Convex에 로그인하세요): npm run dev 브라우저에서 http://localhost:5173 을 엽니다

ai-town은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/a16z-infra/ai-town