KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

GenerativeAgents-Alien-Town

★ 49 Open GitHub ↗

外星小镇（Alien Town）是一个基于 Generative Agents 的智能体小镇实验项目。它让多个 AI 角色在同一个小镇里“思考—对话—行动—创作”，并可自动生成图片（LibLibAI）、音乐（Suno）以及网页/生命游戏代码（Gemini）。项目内置可视化启动器，为开发者提供更方便的使用体验。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

#  GenerativeAgents: Alien Town 外星小镇

![主宣传画面](https://raw.githubusercontent.com/jiejieje/GenerativeAgents-Alien-Town/main/github页面图片/主宣传画面.gif)
 
 
 
 
### 🎯 这是什么？
这是一个**智能AI小镇模拟器**！你可以创造虚拟角色，让他们在小镇里自由生活，而且他们会：
- 🎨 **自己画画** - AI角色会根据自己的心情和想法自动创作图片
- 🎵 **自己作曲** - AI角色会根据自己的心情和想法自主创作音乐 
- 💻 **自己编程** - AI角色会根据自己的想法能写出生命游戏的网页代码模拟生命！

![生成图片/音乐/网页画面](https://raw.githubusercontent.com/jiejieje/GenerativeAgents-Alien-Town/main/github页面图片/生成图片音乐网页画面.gif)
 
 
 
 
### ✨ 主要工作内容（基于x-glacier的GenerativeAgentsCN框架开发）
外星小镇更便捷使用，AI角色更有创造力：
- 🎨 **智能绘画**：基于 LibLibAI 接口，角色可以根据情感和想法自动生成图片
- 🎵 **音乐创作**：基于 Suno 接口，角色能够创作和分享音乐
- 🎮 **代码生成**：基于 Gemini 接口，角色甚至能编写生命游戏等网页应用
- 🖥️ **可视化界面**：一键启动，实时观察角色们的生活
- 🎮 **PixiJS引擎**：使用高性能的PixiJS渲染引擎，流畅展示角色动画和场景
- 🧠 **内置更便宜的大模型**：使用glm-4-flashx-250414模型，单次模拟一百个模拟步骤的成本约0.05元左右

### 实机演示
![实机演示](https://raw.githubusercontent.com/jiejieje/GenerativeAgents-Alien-Town/main/github页面图片/主页实机画面.gif)

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

#### 🔧 环境要求
- Python 3.9 或更高版本（推荐 3.10/3.11）
- vpn网络连接（用于AI服务调用）

#### 💾 安装步骤
1. 下载或克隆项目到本地
2. 安装依赖包：
```bash
pip install -r requirements.txt
```

#### ⚙️ 配置密钥（重要！）
运行前需要在 `data/config.json` 文件中填入AI服务的密钥：

```json
{
  "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

#### 🚀 开始体验

```bash
python AI小镇启动器.py
```
- 打开图形界面，点击选择或创建角色
- 在右上角的设置里设置模拟步数（建议先试试50步）
- 点击"开始模拟"，实时观看角色们的生活！
-  **详细使用教程**：想要更详细的操作指导？查看 [《AI外星小镇使用教程》](github页面图片/AI外星小镇使用教程.pdf)（约3分钟即可学会）

## ✨ 使用方式二：下载预编译版本（推荐给想体验一下的小白用户） 
在GitHub页面右侧的 **Releases** 区域下载最新的打包文件：
- 下载后解压到任意目录
- 双击运行 `AI小镇启动器.exe`
- 无需安装Python环境，开箱即用！

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

### ❓ 常见问题

** Q: 🎯运行时出现卡顿或性能问题？**
 A: 本项目采用高清地图和实时渲染，对设备性能要求较高。如遇卡顿请尝试：
- 在网页前端界面的设置菜单中开启"低性能模式"
- 关闭其他占用资源的应用程序
- 使用性能较好的浏览器（推荐Chrome/Edge）
- 更换配置更高的电脑使用

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

**Q: Windows下出现中文乱码？**
A: 一般不影响运行，如果介意可以尝试：
- 确保文件保存为UTF-8编码
- 在终端中运行 `chcp 65001` 设置UTF-8编码

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

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

### 🗺️ 地图自定义
如何修改小镇地图？请参考我的另一个开源项目：
**[Tiled地图转Maze工具](https://github.com/jiejieje/tiled_to_maze.json)** - 支持将Tiled编辑器制作的地图转换为本项目可用的格式

### 🎭 如何查看AI角色的输入的提示词和作品
模拟运行后，你可以在以下地方找到角色们的创作：
- 📁 `results/`文件夹 - 模拟记录和提示词等数据
- 🎨 生成的图片 - 在 `frontend/static/generated_images/`
- 🎵 创作的音乐 - 在 `frontend/static/generated_music/` 
- 💻 编写的代码 - 在 `frontend/static/generated_html_sims/`

### 📄 许可证
- 项目代码遵循Apache License 2.0协议

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

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

---

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

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

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

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

GenerativeAgents-Alien-Town

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README