nano-banana-project

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #llm #go #golang #docker #nodejs #awesome #cli #security #mcp

nano-banana-project

(★ 5)

No description available.

nano-banana-project Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🍌 NanoBanana 智能美食创意工坊

一个基于 AI 图像生成的创意美食产品，让用户输入现有食材，AI 为您创造独特的美食创意和制作建议。

## ✨ 产品特色

### 🎨 AI 智能创意生成
- 输入现有食材，AI 生成精美的菜品图片
- 支持多种料理风格：中式、西式、日式、韩式、泰式、创意融合
- 智能生成个性化制作建议

### 🤖 智能推荐系统
- 基于用户使用习惯的个性化推荐
- 学习用户偏好的料理风格
- 推荐适合的食材组合

### 📱 现代化用户体验
- 响应式设计，支持移动端
- 流畅的动画效果
- 直观的标签页导航

### 💾 完整功能生态
- 历史记录管理
- 收藏功能
- 分享功能
- 一键复用历史创意

## 🎬 项目演示

### 📺 完整功能演示视频

观看完整的项目功能演示，了解 NanoBanana 智能美食创意工坊的所有特色功能：

<video width="80%" controls poster="data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iODAwIiBoZWlnaHQ9IjQ1MCIgdmlld0JveD0iMCAwIDgwMCA0NTAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxyZWN0IHdpZHRoPSI4MDAiIGhlaWdodD0iNDUwIiBmaWxsPSJ1cmwoI2dyYWRpZW50KSIvPgo8Y2lyY2xlIGN4PSI0MDAiIGN5PSIyMjUiIHI9IjUwIiBmaWxsPSJ3aGl0ZSIgZmlsbC1vcGFjaXR5PSIwLjgiLz4KPHN2ZyB4PSIzNzAiIHk9IjE5NSIgd2lkdGg9IjYwIiBoZWlnaHQ9IjYwIiB2aWV3Qm94PSIwIDAgMjQgMjQiIGZpbGw9Im5vbmUiPgo8cGF0aCBkPSJtOSAxMiA4LTUgOCAxMS04IDVWN2wtOCA1WiIgZmlsbD0iIzMzMyIvPgo8L3N2Zz4KPHR0aXRsZT4i8J+NjCBOYW5vQmFuYW5hIOeUteafneeJiOaWhyI8L3RpdGxlPgo8dGV4dCB4PSI0MDAiIHk9IjMwMCIgZm9udC1mYW1pbHk9IkFyaWFsLCBzYW5zLXNlcmlmIiBmb250LXNpemU9IjI0IiBmaWxsPSJ3aGl0ZSIgdGV4dC1hbmNob3I9Im1pZGRsZSI+8J+NjCBOYW5vQmFuYW5hIOeUteafneeJiOaWhzwvdGV4dD4KPHR0aXRlPiLmt7vlh7rms5XnnInov4fnqIsgQ1RSTCArIENsaWNrIOaSreaUvuinhOmiojwvdGl0bGU+Cjx0ZXh0IHg9IjQwMCIgeT0iMzMwIiBmb250LWZhbWlseT0iQXJpYWwsIHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMTYiIGZpbGw9IndoaXRlIiBmaWxsLW9wYWNpdHk9IjAuOCIgdGV4dC1hbmNob3I9Im1pZGRsZSI+54K55Ye75pKt5pS+6KeG6aKa5a6M5pW05Yqf6IO944CC77iP5Li65LqG6I635oCBMS8/Lz4KPGRlZnM+CjxsaW5lYXJHcmFkaWVudCBpZD0iZ3JhZGllbnQiIHgxPSIwJSIgeTE9IjAlIiB4Mj0iMTAwJSIgeTI9IjEwMCUiPgo8c3RvcCBvZmZzZXQ9IjAlIiBzdHlsZT0ic3RvcC1jb2xvcjojZmZlY2QyO3N0b3Atb3BhY2l0eToxIiAvPgo8c3RvcCBvZmZzZXQ9IjEwMCUiIHN0eWxlPSJzdG9wLWNvbG9yOiNmY2I2OWY7c3RvcC1vcGFjaXR5OjEiIC8+CjwvbGluZWFyR3JhZGllbnQ+CjwvZGVmcz4KPC9zdmc+">
  <source src="./meeting_02.mp4" type="video/mp4">
  您的浏览器不支持 video 标签。请 <a href="./meeting_02.mp4">点击这里下载视频</a> 查看演示。
</video>

*📝 视频大小: 5.4MB | ⏱️ 建议观看时间: 3-5分钟*

</div>

### 🎯 演示内容概览

本演示视频展示了以下核心功能：

- 🎨 **AI 美食创意生成**: 输入食材，AI 自动生成精美菜品图片和制作建议
- 🎮 **美食挑战游戏**: 随机食材挑战，限时创作，积分奖励系统  
- 🥗 **智能营养分析**: AI 营养师专业分析，健康建议生成
- 📖 **历史记录管理**: 创作历史回顾，一键重新生成
- ⭐ **智能收藏系统**: 收藏喜爱的创意，快速复用
- 🏆 **成就系统**: 游戏化体验，解锁各种烹饪成就
- 💡 **个性化推荐**: 基于使用习惯的智能食材推荐

### 📋 观看指南

> 💡 **最佳观看体验**:
> - 🖥️ 建议使用桌面浏览器全屏观看
> - 🔊 开启声音以获得完整体验  
> - ⏸️ 可随时暂停详细了解某个功能
> - 📱 移动端用户可下载后使用视频播放器观看
>
> 🔗 **备用选项**: 如果视频无法正常播放，请 [点击这里直接下载视频文件](./meeting_02.mp4) 使用本地播放器观看。

## 🚀 快速开始

### 环境要求
- Python 3.7+
- Flask 2.3+
- 现代浏览器

### 安装步骤

1. **克隆项目**
```bash
git clone <your-repo-url>
cd nano-banana-project
```

2. **安装依赖**
```bash
pip install -r requirements.txt
```

3. **配置环境变量**
```bash
# 复制环境变量示例文件
copy env_example.txt .env
# 或在 Linux/Mac 上
cp env_example.txt .env

# 编辑 .env 文件，设置您的 API 密钥
# AIGC_API_KEY=sk-your-actual-api-key-here
```

4. **运行应用**
```bash
python app.py
```

5. **访问应用**
打开浏览器访问：`http://localhost:5000`

## 🛠️ 技术架构

### 后端技术栈
- **Flask**: 轻量级 Web 框架
- **Python Requests**: HTTP 客户端
- **JSON**: 数据存储（支持扩展为数据库）

### 前端技术栈
- **原生 HTML/CSS/JavaScript**: 确保性能和兼容性
- **响应式设计**: 支持各种设备尺寸
- **现代 UI**: 采用卡片式设计和渐变效果

### API 集成
- **Imagen 3.0**: 高质量图像生成 API
- **智能提示词**: 针对美食场景优化的提示词生成

## 🎯 核心功能

### 1. 智能菜品生成
```javascript
// 用户输入食材和风格
const ingredients = "鸡蛋, 番茄, 洋葱";
const style = "chinese";

// AI 生成美食创意
const result = await generateDish(ingredients, style);
```

### 2. 多风格支持
- 🥢 **中式料理**: 传统中国菜系风格
- 🍽️ **西式料理**: 欧美菜系风格
- 🍱 **日式料理**: 日本传统菜系
- 🌶️ **韩式料理**: 韩国传统菜系
- 🌿 **泰式料理**: 东南亚风味
- ✨ **创意融合**: 现代创新菜系

### 3. 智能推荐算法
```python
# 基于用户历史偏好的推荐
def recommend_dishes():
    recent_styles = analyze_user_preferences()
    return generate_recommendations(recent_styles)
```

## 📊 项目结构

```
nano-banana-project/
├── app.py                  # 主应用文件
├── requirements.txt        # Python 依赖
├── README.md              # 项目说明
├── meeting_02.mp4         # 项目演示视频
├── config_example.py      # 配置文件示例
├── templates/             # HTML 模板
│   └── index.html         # 主页面
├── static/               # 静态资源
│   ├── style.css         # 样式文件
│   └── script.js         # JavaScript 逻辑
├── history.json          # 历史记录存储
├── favorites.json        # 收藏数据存储
├── achievements.json     # 成就数据存储
└── app.log              # 应用日志文件
```

## 🎨 设计理念

### 用户体验优先
- **简洁直观**: 一目了然的操作流程
- **响应迅速**: 优化的加载和交互体验
- **错误友好**: 完善的错误处理和用户反馈

### 视觉设计
- **现代风格**: 采用卡片式设计和圆角元素
- **温暖配色**: 食物主题的橙色渐变配色
- **动画效果**: 适度的过渡动画增强体验

### 功能完整性
- **边界处理**: 完善的输入验证和错误处理
- **数据持久化**: 历史记录和收藏数据的本地存储
- **扩展性**: 模块化代码结构，便于功能扩展

## 🚀 特色亮点

### 1. 创新性AI应用
- 将图像生成 AI 应用到美食创意场景
- 智能提示词优化，生成高质量美食图片
- 结合料理知识的制作建议生成

### 2. 完整的产品闭环
- 创意生成 → 结果展示 → 收藏管理 → 智能推荐
- 形成用户粘性的产品循环

### 3. 极致的工程质量
- 模块化代码结构
- 完善的错误处理
- 响应式UI设计
- 优化的性能表现

### 4. 用户体验创新
- 食材建议标签，降低输入门槛
- 一键分享功能，增强社交属性
- 智能推荐系统，提升用户粘性

## 🔧 配置说明

### 环境变量配置 (推荐)
1. **复制示例文件**
```bash
copy env_example.txt .env  # Windows
cp env_example.txt .env    # Linux/Mac
```

2. **编辑 .env 文件**
```bash
# AI API 配置
AIGC_API_KEY=sk-your-actual-api-key-here
FLASK_ENV=development
FLASK_DEBUG=True
```

3. **安全提示**
- ⚠️ 请勿将 `.env` 文件提交到代码仓库
- 🔒 生产环境建议使用系统环境变量
- 📝 `env_example.txt` 提供了配置模板

### 传统配置方式
也可通过修改 `config_example.py` 文件进行配置：
```python
# 复制配置文件
copy config_example.py config.py
```

### 自定义设置
- 修改 `CUISINE_STYLES` 字典添加更多料理风格
- 调整 `generate_cooking_suggestions` 函数自定义建议内容
- 扩展推荐算法逻辑

## 🎓 技术亮点

### 1. 智能提示词工程
```python
prompt = f"一道精美的{style_desc}菜品，使用食材：{ingredients}，摆盘精美，专业美食摄影"
```

### 2. 优雅的错误处理
```javascript
async function generateDish() {
    try {
        const result = await fetch('/generate', options);
        // 处理成功响应
    } catch (error) {
        // 优雅的错误处理
        showToast('生成失败，请检查网络连接', 'error');
    }
}
```

### 3. 响应式设计
```css
@media (max-width: 768px) {
    .dish-result {
        grid-template-columns: 1fr;
    }
}
```

## 🌟 未来规划

- [ ] 添加用户账户系统
- [ ] 实现菜品评分和评论功能
- [ ] 集成更多AI模型支持
- [ ] 添加营养分析功能
- [ ] 支持菜谱生成
- [ ] 社区分享平台

### 技术选型理由
- **Flask**: 轻量级，开发效率高
- **原生前端**: 确保性能，减少依赖
- **JSON存储**: 简化部署，支持后续数据库迁移

## 📞 联系方式

如有任何问题或建议，欢迎联系开发者！

---

**🍌 NanoBanana 智能美食创意工坊 - 让 AI 为你的餐桌增添创意！**

nano-banana-project

nano-banana-project Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

nano-banana-project

nano-banana-project Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README