a16z-infra/ai-town

A MIT-licensed, deployable starter kit for building and customizing your own version of AI town - a virtual town where AI characters live, chat and socialize.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 20 minutes ago
Added to GitGenius on September 5th, 2026
Created on July 16th, 2023
Open Issues & Pull Requests: 72 (+0)
GitHub issues: Enabled
Number of forks: 1,183
Total Stargazers: 10,453 (+0)
Total Subscribers: 81 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 19.1 hours
Mean response time: 15.0 days
90th percentile: 48.3 days
Tracked items: 58

How this project is maintained

97% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Three people close 93% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 67
New in 7 days: 1
Closed in 7 days: 0
Avg open age: 876 days
Stale 30+ days: 66
Stale 90+ days: 0

Recent activity

Opened in 7 days: 1
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • enhancement (8)
  • bug (3)
  • good first issue (1)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

AI Town is a deployable starter kit for building virtual worlds where AI characters live, chat, and socialize.

The project addresses the challenge of creating interactive multi-agent simulations by providing a TypeScript-based framework inspired by research on generative agents. It uses Convex as its backend to handle shared global state, transactions, and simulation logic, allowing characters to interact autonomously within a persistent virtual environment. The system supports multiple LLM providers including Ollama for local inference, OpenAI, and Together.ai, with configurable embeddings and optional features like music generation through Replicate.

Developers should choose this tool if they want to experiment with multi-agent AI simulations or build a customizable virtual world without starting from scratch. The starter kit is designed to scale from simple prototypes to multiplayer games and provides a strong foundation meant to be extended. The TypeScript implementation fills a gap, as most existing simulators in this space are written in Python. The project supports multiple deployment options including cloud hosting, local development, Docker, and self-hosting on platforms like Fly.io, making it accessible regardless of infrastructure preference.

Development activity shows consistent engagement with the codebase through regular updates and refinements to the simulation engine and character interactions. The project maintains active community involvement through a dedicated Discord server for developers building on the AI Stack. Documentation covers configuration across different LLM providers and deployment scenarios, indicating attention to supporting diverse use cases. The starter kit approach suggests ongoing focus on making the platform accessible to developers who want to customize and extend the simulation rather than use it as-is.