aPix Image Workspace

Tiếng Việt

Giới thiệu

aPix Image Workspace là một giao diện Flask nhẹ giúp bạn tạo hình ảnh bằng API Model Gemini Image 3 Pro (Nano Banana Pro). Bạn có thể gửi prompt, upload tài liệu tham khảo và điều chỉnh tỷ lệ khung hình/độ phân giải.

Ảnh preview được lưu ngay tại preview.jpeg nếu bạn cần xem offline hoặc nhúng lại trong tài liệu khác.

Cài đặt

Tạo môi trường ảo (ví dụ python -m venv .venv) và kích hoạt nó.
Cài đặt dependency:
```
pip install -r requirements.txt
```

Khởi chạy nhanh bằng `run_app`

Đặt GOOGLE_API_KEY qua biến môi trường hoặc giao diện.
Dùng ./run_app.sh (macOS/Linux) hoặc run_app.bat/run_app.command (Windows) để tự động tìm Python, tạo .venv, cài requirements.txt và khởi động app.py.
Mở http://127.0.0.1:8888, nhập prompt/tùy chọn rồi nhấn Generate.
Hình ảnh mới nằm trong static/generated/; /gallery thể hiện lịch sử.

Sử dụng

Đặt biến môi trường GOOGLE_API_KEY với API key của Google GenAI hoặc nhập trực tiếp trong giao diện.
Chạy Flask:
```
python app.py
```
Mở trình duyệt tới http://127.0.0.1:8888, nhập prompt, chọn tùy chọn và nhấn Generate.
Hình ảnh: static/generated lưu nội dung mới nhất, còn /gallery trả về URL cho phần lịch sử.

English

Overview

aPix Image Workspace is a lightweight Flask frontend for Google GenAI image generation powered by the Gemini Image 3 Pro (Nano Banana Pro) model. Submit a prompt, include reference files if needed, and choose aspect ratio/resolution.

The preview screenshot is also stored as preview.jpeg in the repo for offline use or documentation embeds.

Setup

Create & activate a virtual environment (e.g., python -m venv .venv).
Install dependencies:
```
pip install -r requirements.txt
```
macOS/Linux users can run ./run_app.sh; Windows users can use run_app.bat (or run_app.command) to auto-detect Python, create the .venv, install deps, and launch the Flask server on port 8888.

Quick start via `run_app`

Export GOOGLE_API_KEY via your environment or the UI form.
On macOS/Linux run ./run_app.sh (or run_app.command); on Windows use run_app.bat or run_app.command.
- The script detects python3/python, creates .venv, installs requirements.txt, activates the virtualenv, and then launches app.py.
Open http://127.0.0.1:8888, submit prompts/options, and click Generate.
New images appear under static/generated/, and /gallery exposes the history.

2.8 KiB Raw Blame History