https://github.com/vero-code/gameassets-ai

AI-powered forge for indie game developers. ⚔️ Instantly create endless asset variations using Black Forest Labs' FLUX.1 Kontext model.
https://github.com/vero-code/gameassets-ai

black-forest-labs flux game-assets game-development generative-ai gradio hackathon machine-learning python

Last synced: 5 months ago
JSON representation

AI-powered forge for indie game developers. ⚔️ Instantly create endless asset variations using Black Forest Labs' FLUX.1 Kontext model.

• Host: GitHub
• URL: https://github.com/vero-code/gameassets-ai
• Owner: vero-code
• License: mit
• Created: 2025-09-20T10:36:30.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2025-09-21T12:21:48.000Z (6 months ago)
• Last Synced: 2025-09-21T14:31:34.681Z (6 months ago)
• Topics: black-forest-labs, flux, game-assets, game-development, generative-ai, gradio, hackathon, machine-learning, python
• Language: Python
• Homepage: https://devpost.com/software/gameassets-ai
• Size: 6.17 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# GameAssets AI ⚔️

[![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white)](https://www.python.org/)

[![Gradio](https://img.shields.io/badge/Gradio-UI-orange?logo=gradio)](https://www.gradio.app/)

[![fal.ai](https://img.shields.io/badge/fal.ai-API-green?logo=fastapi&logoColor=white)](https://fal.ai)

[![FLUX.1 Kontext](https://img.shields.io/badge/FLUX.1-Kontext-purple?logo=openai&logoColor=white)](https://blackforestlabs.ai/)

An AI-powered forge for indie developers to generate and transform game assets. Upload a base sprite and instantly create endless fantasy variations using the **FLUX.1 Kontext [dev]** model. 

*This project was built for the [Black Forest Labs - FLUX.1 Kontext [dev] Hackathon](https://devpost.com/software/gameassets-ai)*.

![GameAssets AI Logo](assets/logo.png)

🎥 Watch the demo video here: [YouTube link](https://youtu.be/7aJzwBhNUwQ)

## 🚀 Features

  - **Dual Generation Modes:** Choose between two powerful modes for different creative needs. 

  - 🎨 **Inspiration Mode:** Upload a base asset and instantly generate four unique, stylized variations (Fiery, Icy, Ancient, Magic) to spark new ideas. 

  - 🎯 **Single Image Mode:** Take full control by writing a detailed prompt to generate a single, specific asset. 

  - **Interactive UI:** A simple and intuitive web interface built with Gradio. No command line needed. 

  - **Clickable Examples:** Get started immediately by selecting one of the built-in examples (shield, mace, potion, boots).

## 🛠️ Technology & Model

- **Core AI Model:**  **FLUX.1 Kontext [dev]** by Black Forest Labs

- **Cloud Inference:**  **fal.ai** for running the model via API

- **Web Interface:**  **Gradio** for creating the interactive UI

- **Core Language:**  **Python**

- **Key Libraries:**  **Pillow** (for image processing), **Requests** (for handling web data)

## 📦 Installation

Follow these steps to get the application running locally.

### 1. Clone the Repository

```bash

git clone https://github.com/vero-code/gameassets-ai.git

cd gameassets-ai

```

### 2. Create Virtual Environment & Install Dependencies

```bash

# Create and activate the virtual environment 

python -m venv venv 

venv\Scripts\activate 

# Install required packages

pip install -r requirements.txt

```

### 3. Add Asset Examples

Create a folder named `assets` in the project's root directory and download the example images into it.

### 4. Set Up API Key

1.  Get your API key from **fal.ai**.

    

2.  Create a file named `.env` in the project's root directory.

    

3.  Add your key to the file like this:

```

FAL_KEY="your_fal_key_here"

```

## ▶️ Usage

With your environment activated and the `.env` file in place, run the application:

```bash

python src/app.py

```

This will start a local web server. Open the URL provided in the terminal (usually `http://127.0.0.1:7860`) in your web browser to use the app.

  

### 🖍️ Test file

Run test script:

`python src/test_api.py`

It will send a request to FLUX.1 Kontext [dev] and return a generated image URL.

Example output:

`Generated image URL: https://v3b.fal.media/files/...jpg Size: 832 x 448 Inference time: 1.26 seconds`

## 📂 Project structure

```

gameassets-ai/

├─ assets/

│ └─ ...

├─ src/

│ ├─ app.py

│ └─ test_api.py

├─ venv/

├─ .env.example

├─ .gitignore

├─ README.md

└─ requirements.txt

```

## 📄 License

This project is licensed under the **MIT License**.