mewamew/my_ai_town

我的AI小镇

What it solves

这个项目创建一个由AI居民自己生活的小镇。居民会做日常安排、使用物品、结识邻居,并记住自己的亲身经历。传统游戏里的NPC只会按脚本行动,而这里的居民由大语言模型驱动,能根据环境和记忆自主决策。你既可以旁观他们的生活,也可以创建化身走进小镇和他们聊天互动。

How it works

居民的行动由两个部分组成:模型负责提出想法和行动,世界内核负责检查和执行。模型就像居民的大脑,给出下一步想做什么的指令;Rust编写的世界内核则验证这些指令是否符合世界规则,并在世界里实际执行。发生的事情以世界里的实际结果为准,而不是模型说什么就是什么。

新版使用Rust作为世界内核,浏览器客户端用TypeScript和Three.js构建HD-2D画面。居民有想法、计划、身体状态、日记、记忆等数据。你可以拖动缩放地图,跟随居民观察他们的活动。创建化身后可以用鼠标或键盘移动,与居民对话、使用物品、写公告等。

项目提供内置的本地小模型,专用于村民日常决策,不需要额外配置API密钥;也可以为居民连接在线模型。模型不可用时相关决策会暂停,本地模型的能力受设备限制。

Who it's for

这个项目适合对AI模拟、智能体行为和交互式叙事感兴趣的人。无论你是想观察AI如何自主生活,还是希望参与其中与AI角色互动,都能找到乐趣。它也适合开发者研究如何用Rust和Three.js构建支持多平台(macOS、Android、Windows)的AI应用。注意当前Windows支持还是实验性的,未做实机验证。

Highlights

  • 居民由大语言模型驱动,有记忆、需求、计划和情感状态,行为受环境影响
  • 世界内核用Rust实现,确保行动按实际规则执行,结果可靠
  • 支持观察模式或创建化身进入小镇,与居民真实对话和互动
  • 提供内置本地小模型,无需API密钥即可运行村民决策
  • 跨平台:macOS、Android提供应用壳,Windows为实验性支持
  • HD-2D画面,像素风角色和立体场景,有昼夜和天气变化
  • 可以邀请居民、修改人设、创建新小镇和编辑地图

Related

  • Project
  • Project
  • Project
  • Project