GenerativeAgents: Alien Town 外星小镇

🎯 这是什么？

这是一个智能AI小镇模拟器！你可以创造虚拟角色，让他们在小镇里自由生活，而且他们会：

🎨 自己画画 - AI角色会根据自己的心情和想法自动创作图片
🎵 自己作曲 - AI角色会根据自己的心情和想法自主创作音乐
💻 自己编程 - AI角色会根据自己的想法能写出生命游戏的网页代码模拟生命！

✨ 主要工作内容（基于x-glacier的GenerativeAgentsCN框架开发）

外星小镇更便捷使用，AI角色更有创造力：

🎨 智能绘画：基于 LibLibAI 接口，角色可以根据情感和想法自动生成图片
🎵 音乐创作：基于 Suno 接口，角色能够创作和分享音乐
🎮 代码生成：基于 Gemini 接口，角色甚至能编写生命游戏等网页应用
🖥️ 可视化界面：一键启动，实时观察角色们的生活
🎮 PixiJS引擎：使用高性能的PixiJS渲染引擎，流畅展示角色动画和场景
🧠 内置更便宜的大模型：使用glm-4-flashx-250414模型，单次模拟一百个模拟步骤的成本约0.05元左右

实机演示

🚀 使用方式一（源码运行）🚀

🔧 环境要求

Python 3.9 或更高版本（推荐 3.10/3.11）
vpn网络连接（用于AI服务调用）

💾 安装步骤

下载或克隆项目到本地
安装依赖包：

pip install -r requirements.txt

⚙️ 配置密钥（重要！）

运行前需要在 data/config.json 文件中填入AI服务的密钥：

{
  "agent_base": {
    "associate": {
      "embedding": {
        "type": "zhipuai",
        "model": "embedding-2",
        "api_key": "你的智谱AI密钥"
      }
    }
  },
  "services": {
    "gemini": { 
      "api_key": "你的Gemini密钥", 
      "base_url": "https://generativelanguage.googleapis.com/v1beta/openai/",
      "model": "gemini-2.5-flash"
    },
    "suno": { 
      "api_key": "你的Suno音乐API密钥", 
      "base_url": "https://apibox.erweima.ai"
    },
    "liblibai": { 
      "access_key": "你的LibLibAI访问密钥", 
      "secret_key": "你的LibLibAI秘密密钥", 
      "base_url": "https://openapi.liblibai.cloud"
    }
  }
}

💡 小便签：

智谱AI（API成本约2元左右可以使用非常久）：用于角色的基础对话和思考，对应网址：https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys
Gemini（API每天有免费1百万token使用）：用于代码生成功能，对应网址：https://aistudio.google.com/app/apikey
SunoAI（API相对较贵一点，5元约能生成100首音乐）：用于音乐创作功能，对应网址：https://sunoapi.org/zh-CN
LibLibAI（API约0.1元一张图片）：用于图片绘画功能，对应网址：https://www.liblib.art/apis

🚀 开始体验

python AI小镇启动器.py

打开图形界面，点击选择或创建角色
在右上角的设置里设置模拟步数（建议先试试50步）
点击"开始模拟"，实时观看角色们的生活！
详细使用教程：想要更详细的操作指导？查看《AI外星小镇使用教程》（约3分钟即可学会）

✨ 使用方式二：下载预编译版本（推荐给想体验一下的小白用户）

在GitHub页面右侧的 Releases 区域下载最新的打包文件：

下载后解压到任意目录
双击运行 AI小镇启动器.exe
无需安装Python环境，开箱即用！

⚠️ 重要提示：
Releases打包版本使用的是开发者个人的API密钥，目前账号还有余额供大家免费体验。如果运行时没有看到AI角色生成图片和音乐，说明余额已耗尽，此时需要你在_internal\data文件夹里找到config.json配置自己的API密钥才能继续使用。

❓ 常见问题

** Q: 🎯运行时出现卡顿或性能问题？**
A: 本项目采用高清地图和实时渲染，对设备性能要求较高。如遇卡顿请尝试：

在网页前端界面的设置菜单中开启"低性能模式"
关闭其他占用资源的应用程序
使用性能较好的浏览器（推荐Chrome/Edge）
更换配置更高的电脑使用

Q:🎯 角色不生成图片/音乐/生命游戏代码？
A: 请按以下步骤检查：

确认对应的API密钥已正确配置，并且账户有足够余额
网络环境要求：
- 🎵 音乐/生命游戏代码：需要开启VPN（推荐香港地区）
- 🎨 图片生成：需要关闭VPN，使用国内网络
由于使用的API服务商来自全球各地，暂时无法在统一网络环境下运行，给您带来不便敬请谅解

Q: Windows下出现中文乱码？
A: 一般不影响运行，如果介意可以尝试：

确保文件保存为UTF-8编码
在终端中运行 chcp 65001 设置UTF-8编码

Q: 提示缺少 PySide6 怎么办？
A: 运行 pip install PySide6 安装图形界面库

Q: 运行时说缺少密钥？
A: 检查 data/config.json 文件，确保填入了正确的API密钥

🗺️ 地图自定义

如何修改小镇地图？请参考我的另一个开源项目：
Tiled地图转Maze工具 - 支持将Tiled编辑器制作的地图转换为本项目可用的格式

🎭 如何查看AI角色的输入的提示词和作品

模拟运行后，你可以在以下地方找到角色们的创作：

📁 results/文件夹 - 模拟记录和提示词等数据
🎨 生成的图片 - 在 frontend/static/generated_images/
🎵 创作的音乐 - 在 frontend/static/generated_music/
💻 编写的代码 - 在 frontend/static/generated_html_sims/

📄 许可证

项目代码遵循Apache License 2.0协议

🙏 致谢

特别感谢以下开源项目和贡献者：

x-glacier/GenerativeAgentsCN - 非常感谢 x-glacier 大佬提供的中文化框架和建设性建议。没有x-glacier 精心构建的基础架构，这个外星小镇项目可能不会实现。
Stanford Generative Agents - 非常感谢joonspk-research开源的项目和论文提供了理论基础和核心思想。
Pixi.js - 非常感谢pixiJS高效的网页引擎让高清分辨率地图展示成为可能

💌 作者的话

作为一名美术专业的学生，我深知自己在编程技术上还有很多不足之处。这个项目更多是出于对AI和创意结合的热情而诞生的实验性作品。

如果您在使用过程中发现任何bug、代码问题或有改进建议，非常欢迎通过Issue与我交流指正。每一个反馈都是我学习进步的宝贵机会！

同时也希望这个小镇能给大家带来一些乐趣和灵感。

⭐ 如果你觉得这个项目有趣，欢迎给个Star支持！
💬 有问题或建议欢迎提Issue一起讨论

jiejieje/GenerativeAgents-Alien-Town