# 网页应用生成器

一个基于大模型的网页应用生成器，通过自然语言描述自动生成可运行的 React 或 HTML 代码。

## 功能特性

- **自然语言生成代码**：输入需求描述，自动生成完整的网页应用代码
- **支持 React / HTML**：默认使用 React + Tailwind CSS，也可按需生成原生 HTML
- **内置代码沙箱**：实时预览生成的网页效果
- **代码下载**：支持一键下载生成的源代码
- **对话历史**：支持多轮对话，持续迭代优化生成的页面

## 技术栈

- Python 3.13+
- Gradio
- ModelScope Studio
- OpenAI API / OpenRouter

## 快速开始

### 本地运行

1. 克隆仓库并进入目录
2. 配置环境变量（复制 `.env` 并填写）：
   ```bash
   cp .env.example .env
   ```
3. 使用 uv 安装依赖并启动：
   ```bash
   uv run python app.py
   ```
4. 打开浏览器访问 `http://localhost:7860`


## 项目结构

```
.
├── app.py          # Gradio 应用主入口
├── config.py       # 配置与系统提示词
├── logo.png        # 应用 Logo
├── pyproject.toml  # Python 项目配置
├── Dockerfile      # 容器镜像构建
└── README.md       # 项目说明
```

## 配置说明

在 `.env` 文件中配置以下环境变量：

| 变量名 | 说明 |
|--------|------|
| `OPENAI_API_KEY` | API 密钥 |
| `OPENAI_MODEL` | 使用的模型名称 |
| `OPENAI_BASE_URL` | API 基础地址 |

## 许可证

Apache-2.0
