---
title: "Kitchen Style Transformer"
emoji: "🏡"
colorFrom: "green"
colorTo: "gray"
sdk: "docker"
app_file: "app.py"
pinned: false
---


# 🏡 Kitchen Style Transformer - AI Interior Restyler

🎯 **Biến ảnh nhà bếp (hoặc bất kỳ không gian nội thất nào) sang phong cách mới**, giữ nguyên bố cục – sử dụng AI ControlNet + Stable Diffusion.

---

## 🚀 Giới thiệu

Ứng dụng cho phép bạn:
- Upload một bức ảnh nhà bếp hiện tại
- Nhập prompt mô tả phong cách mới bạn mong muốn (ví dụ: "Modern Scandinavian kitchen with light wood")
- AI sẽ giữ lại bố cục gốc và biến đổi toàn bộ vật liệu, ánh sáng, nội thất theo phong cách mới

---

## 🧪 API Usage (POST `/transform/`)

**Endpoint**: `POST /transform/`  
**Content-Type**: `multipart/form-data`

### Parameters:
| Tên trường | Kiểu dữ liệu | Mô tả |
|------------|--------------|--------|
| `image`    | File (.png/.jpg) | Ảnh nội thất gốc |
| `prompt`   | Text | Mô tả phong cách bạn muốn AI biến đổi sang |

### Response:
Ảnh đã được biến đổi theo phong cách mong muốn (dưới dạng file `.png`)

---

## 🛠 Cấu hình Docker

Project này được triển khai bằng:

- `FastAPI` – web API framework
- `Stable Diffusion v1.5` – từ runwayml
- `ControlNet (Canny)` – giữ bố cục ảnh gốc
- Dockerfile tối ưu hóa cho Hugging Face Spaces với GPU

---

## ⚙️ Yêu cầu phần cứng

- GPU bắt buộc (ví dụ: A10G, T4, V100)
- RAM tối thiểu: 8GB
- Cần kết nối mạng để tải model trong lần đầu

---

## 📜 License

- Mã nguồn: **MIT License** – tự do sử dụng cá nhân và thương mại
- Models:  
  - **Stable Diffusion v1.5** & **ControlNet** đều theo giấy phép **CreativeML Open RAIL-M**  
  - Không dùng cho nội dung lừa đảo, thù hận hoặc xâm phạm quyền riêng tư người khác

> This project uses models from `runwayml` and `lllyasviel`, provided under the CreativeML Open RAIL-M License.  
> Source code © 2025 Loi Hang – released under the MIT License.

---

## ✨ Ví dụ prompt gợi ý

```text
Modern Japandi kitchen with wood textures and sunlight
Futuristic kitchen with neon lights and minimal design
Dark marble luxury kitchen with gold details