Repolode
a16z-infra

a16z-infra/ai-town

一个可部署的开源入门套件,用于搭建和定制 AI 小镇,AI 角色在虚拟小镇中生活、聊天和社交。

Star
10,676
Fork
1,227
未关闭 Issue
75
最近提交
2个月前

这是什么?

AI Town 是一个让 AI 角色在虚拟小镇中生活、聊天和社交的项目。它是一个可部署的入门套件,灵感来自论文《Generative Agents》,用户可以在此基础上搭建和定制自己的小镇。项目使用 TypeScript 编写,后端基于 Convex,提供共享全局状态、事务和模拟引擎,便于扩展。

技术栈以 Convex 作为游戏引擎、数据库和向量检索的核心,认证可选用 Clerk。角色通过数据文件配置,地图可用 Tiled 编辑并借助脚本转换。默认通过 Ollama 运行 llama3 对话模型,也支持 Together.ai 及任何兼容 OpenAI API 的服务。背景音乐可借助 Replicate 生成,前端渲染使用 PixiJS。

部署方式包括标准的 Convex 云端开发流程、基于 Docker Compose 的自托管方案,以及部署到 Fly.io。前端可部署到 Vercel;若后端在云端,本地 Ollama 可通过 ngrok 或 Tunnelmole 等隧道服务对外提供访问。

核心功能

  • 01模拟小镇,AI 角色之间可以相互聊天和社交。
  • 02基于 Convex 构建,提供共享状态、事务和模拟引擎。
  • 03支持通过 Ollama 本地推理,也支持 Together.ai 及兼容 OpenAI API 的服务。
  • 04角色、精灵图和地图均可自定义,地图可用 Tiled 编辑。
  • 05可选借助 Replicate 生成背景音乐。
  • 06可本地运行、用 Docker Compose 自托管,或部署到 Convex 云、Fly.io 和 Vercel。

适用场景

  • 学习生成式智能体如何在虚拟世界中模拟社交行为。
  • 用 LLM 驱动的角色原型化多智能体模拟或小型多人游戏。
  • 用自己的角色、故事和地图搭建定制化的虚拟小镇。
  • 通过 Ollama 在自包含环境中试验本地大模型。

快速上手

  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

使用前须知

  • 默认配置需要免费的 Convex 账号,并需本地安装 Ollama 及 llama3 模型才能进行 AI 对话。
  • 使用 OpenAI 或 Together.ai 等云端大模型需要付费的 API 密钥。
  • Windows 用户需要安装 WSL2 并使用类似 Ubuntu 的环境。

标签

常见问题

ai-town 是什么?
一个可部署的开源入门套件,用于搭建和定制 AI 小镇,AI 角色在虚拟小镇中生活、聊天和社交。 AI Town 是一个让 AI 角色在虚拟小镇中生活、聊天和社交的项目。它是一个可部署的入门套件,灵感来自论文《Generative Agents》,用户可以在此基础上搭建和定制自己的小镇。项目使用 TypeScript 编写,后端基于 Convex,提供共享全局状态、事务和模拟引擎,便于扩展。
ai-town 可以免费使用吗?用的什么许可证?
ai-town 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
ai-town 还在维护吗?
半年内有更新。ai-town 最近一次提交是在 2026年8月26日。
ai-town 适合用来做什么?
学习生成式智能体如何在虚拟世界中模拟社交行为。 用 LLM 驱动的角色原型化多智能体模拟或小型多人游戏。 用自己的角色、故事和地图搭建定制化的虚拟小镇。 通过 Ollama 在自包含环境中试验本地大模型。
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

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目