# 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.

Repository: https://github.com/a16z-infra/ai-town
Canonical: https://ross.abutalabs.com/products/ai-town
Homepage: https://convex.dev/ai-town
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-08-26T00:34:11+00:00

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 81
- inputs: {"age_days": 1144, "days_push": 8, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 10392, forks 1172 (observed 2026-08-28T04:10:41.856399+00:00)

## What it is
AI Town is a deployable starter kit for building a virtual town where AI characters live, chat, and socialize, inspired by the Generative Agents research paper. It is built on Convex with vector search, supports configurable LLMs (Ollama, OpenAI, Together.ai), and renders the world with PixiJS.

## Use cases
- build a virtual town with AI characters
- create a generative agents simulation
- customize an AI NPC social world
- run a multiplayer AI character game
- experiment with LLM-driven agents in a shared world
- self-host an AI simulation with local models

## When to choose
- you want a ready-to-deploy, customizable AI agent simulation in TypeScript
- you want to experiment with generative agents using local or cloud LLMs
- you need a scalable multiplayer simulation foundation on Convex

## When to avoid
- you need a production game engine or polished commercial game
- you want a Python-based agent research framework
- you need fine-grained control over the simulation engine internals

## Facets
- artifact type: application
- maturity: active
- function: agent-framework, llm-inference, rag, chatbot, game-engine, vector-database, web-framework
- domain: artificial-intelligence, large-language-models, simulation, web-development
- platform: self-hosted, cloud
- tags: generative-agents, virtual-town, convex, ollama, pixijs, starter-kit, multiplayer-simulation, pixel-art, ai-agents, game-development, typescript, nodejs, web-server, docker

## Member repositories
- a16z-infra/ai-town (main) score 73

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:41.856399+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:19:05.112217+00:00, confidence not recorded.
  - readme: https://github.com/a16z-infra/ai-town (fetched 2026-08-28T04:10:41.856399+00:00, sha f38d85072ba8)
  - homepage: https://convex.dev/ai-town (fetched 2026-08-29T08:18:34.418378+00:00, sha c3c8397991fd)
- Data as of 2026-08-30T08:39:29.467469+00:00.