SceneMuse

中文说明 | English Description

🇨🇳 SceneMuse - AI 驱动的 3D 场景生成与 UE 联动工具

版本: v4.0

SceneMuse 是一个集成了 文字生成图片、图片生成 3D 模型 以及 Unreal Engine 5 场景联动 的全流程 AI 工具。它旨在帮助游戏开发者和设计师快速从创意构思原型到 3D 资产落地。

✨ 核心功能

多模态生成: 调用 Doubao SeedDream API 生成高质量 2D 参考图，支持参考图输入。
3D 模型转换: 集成 Tripo3D API，批量将 2D 图片转换为 GLB 3D 模型。
UE5 无缝导出: 一键将生成的模型导入 Unreal Engine 项目目录。
AI 场景控制: 通过 DeepSeek Chat API 和 MCP 协议，使用自然语言控制 UE5 场景（如“把场景调成夜晚”、“在中心放个光源”）。
环境预设: 提供多种光照环境预设（晴天、黄昏、雨天、夜晚）。

🛠️ 项目结构

SceneMusev4/
├── core/               # 核心逻辑 (API 调用, 配置, 线程)
├── ui/                 # 界面代码 (PyQt5)
├── SceneMuse_Docs/    # 详细设计文档 (包含架构图、时序图)
├── assets/             # 资源文件
├── generated/          # 生成的资产输出目录 (由程序自动生成)
├── .env.example        # 环境变量配置模板
└── main.py             # 程序入口

🚀 快速开始

1. 克隆仓库

git clone https://github.coventry.ac.uk/zhanh6/SceneMuse.git
cd SceneMuse

2. 安装依赖

务必使用 Python 3.10 或更高版本。

pip install PyQt5 requests python-dotenv

3. 配置 API 密钥

在项目根目录创建一个 .env 文件（您可以复制 .env.example 重命名），并填入您的 API 密钥：

DOUBAO_API_KEY=your_doubao_key
TRIPO_API_KEY=your_tripo_key
DEEPSEEK_API_KEY=your_deepseek_key

注意: 不要将您的 .env 文件上传到公共仓库。

4. 运行程序

python main.py

5. 打包为 EXE (Windows)

如果您想生成可执行文件，可以直接运行批处理脚本：

./build_exe.bat

🇺🇸 SceneMuse - AI-Driven 3D Scene Generation & UE Integration

Version: v4.0

SceneMuse is an all-in-one AI tool unifying Text-to-Image, Image-to-3D, and Unreal Engine 5 Scene Integration. It helps game developers and designers rapidly prototype 3D assets from concepts.

✨ Features

Multimodal Generation: Generate high-quality 2D reference images using Doubao SeedDream API.
3D Conversion: Batch convert 2D images to GLB 3D models via Tripo3D API.
Seamless UE5 Export: One-click import of generated models into Unreal Engine projects.
AI Scene Control: Control UE5 scenes using natural language (e.g., "Make it night", "Add a light in center") powered by DeepSeek Chat API & MCP protocol.
Environment Presets: Instant lighting setups (Sunny, Sunset, Rain, Night).

🛠️ Project Structure

SceneMusev4/
├── core/               # Core logic (API calls, config, threads)
├── ui/                 # UI implementation (PyQt5)
├── SceneMuse_Docs/    # Detailed design documentation
├── assets/             # Assets
├── generated/          # Output directory for assets (auto-generated)
├── .env.example        # Environment variables template
└── main.py             # Application entry point

🚀 Quick Start

1. Clone Repository

git clone https://github.coventry.ac.uk/zhanh6/SceneMuse.git
cd SceneMuse

2. Install Dependencies

Python 3.10 or higher is required.

pip install PyQt5 requests python-dotenv

3. Configure API Keys

Create a .env file in the root directory (you can copy .env.example), and fill in your actual API keys:

DOUBAO_API_KEY=your_doubao_key
TRIPO_API_KEY=your_tripo_key
DEEPSEEK_API_KEY=your_deepseek_key

Note: Do not upload your .env file to public repositories.

4. Run Application

python main.py

5. Build EXE (Windows)

To create a standalone executable, run the batch script:

./build_exe.bat

zhanh6/SceneMuse

About

Resources

Stars

Watchers

Forks

Releases

Languages