🃏 AI Card Generator

This project is a 🏗️ card generator that allows you to create custom cards for various purposes. The main goal is to use the generated images as assets in a 🎮 game being developed. Another 🔥 Bedrock-powered tool!

⚙️ Installation

1️⃣ Clone the Repository

git clone https://github.com/felipedbene/card_generator.git

2️⃣ Navigate to the Project Directory

cd card_generator

3️⃣ Install Dependencies with uv

The project uses uv for managing dependencies efficiently. To install all required dependencies, run:

uv pip install

This will automatically install the dependencies specified in pyproject.toml.

Alternatively, if you need to update dependencies later, you can run:

uv pip install --upgrade

4️⃣ Create & Activate a Virtual Environment

To keep dependencies isolated, create and activate a virtual environment:

uv venv init
source .venv/bin/activate

🚀 Usage

1️⃣ Run the 🃏 Card Generator Script

python card_generator.py

2️⃣ What Happens?

• The script generates a full tarot deck 🃏 based on the predefined deck 📜 structure.
• Ensures accurate 🎭 symbolism and consistency with traditional 🔮 tarot readings.
• Saves generated 🖼️ cards in a timestamped directory under tarot_images/:

  tarot_images/tarot_run-YYYYMMDD-HHMMSS/
  

• Each 📂 file is named according to the 🃏 card title, e.g., the_fool.png, the_magician.png.

🎯 Expected Results

After running the script, you should find a complete 78-card 🔮 tarot deck in the corresponding ⏳ timestamped 📂 directory within tarot_images/. The generated deck closely resembles the traditional tarot structure in terms of composition and symbolic accuracy.

Each 🃏 card is generated with:

• 📜 Predefined descriptions ensuring accurate 🖼️ representation.
• 🎭 Symbolism matching traditional 🔮 tarot interpretations.
• 🎨 Consistent framing and design across all 🃏 cards.

🤝 Contributing

1️⃣ Fork the 📂 repository. 2️⃣ Create a new 🌿 branch:

git checkout -b feature-branch

3️⃣ Make changes and 💾 commit them:

git commit -m "Description of changes"

4️⃣ Push to the 🌿 branch:

git push origin feature-branch

5️⃣ Create a 🔀 pull request.

🛡️ License

This project is licensed under the 📝 MIT License. See the LICENSE file for details.