---
title: AI Tarot Reading
emoji: 🔮
colorFrom: purple
colorTo: pink
sdk: gradio
sdk_version: 5.44.1
app_file: app.py
pinned: false
license: apache-2.0
short_description: AI tarot readings
---

# 🔮 AI Tarot Reading

This Space provides AI-powered tarot card readings using a fine-tuned TinyLlama model specifically trained for tarot predictions.

## Features

- **AI-Powered Readings**: Get insightful tarot card interpretations using advanced language models
- **Customizable Inputs**: Choose any tarot card and orientation (upright/reversed)
- **Optional Questions**: Ask specific questions for personalized readings
- **API Access**: Use the model programmatically via API endpoints

## How to Use

1. **Select a Card**: Enter the name of any tarot card (e.g., "The Fool", "The Magician")
2. **Choose Orientation**: Select "upright" or "reversed"
3. **Ask a Question** (Optional): Add a specific question for more personalized readings
4. **Get Your Reading**: Click "Get Reading" to receive your AI-generated tarot interpretation

## API Usage

You can also use this model via API:

```python
import requests

# Make a prediction
response = requests.post(
    "https://ukccatc-tarot.hf.space/api/predict",
    json={
        "data": ["The Fool", "upright", "What should I focus on in my career?"]
    }
)

result = response.json()
print(result["data"])  # Your tarot reading
```

## Model Information

- **Base Model**: TinyLlama-1.1B-Chat-v1.0
- **Fine-tuned for**: Tarot card predictions and interpretations
- **Training Data**: Custom tarot dataset
- **Capabilities**: Love, career, and general life guidance

## Popular Tarot Cards

- **The Fool** - New beginnings, innocence, spontaneity
- **The Magician** - Manifestation, willpower, skill
- **The High Priestess** - Intuition, mystery, subconscious
- **The Empress** - Fertility, abundance, nature
- **The Emperor** - Authority, structure, control
- **The Lovers** - Love, relationships, choices
- **The Chariot** - Determination, willpower, victory
- **Strength** - Inner strength, courage, patience
- **The Hermit** - Soul-searching, introspection, guidance
- **Wheel of Fortune** - Change, cycles, destiny

## Disclaimer

This is an AI-generated tarot reading tool for entertainment purposes. The readings should not be considered as professional advice or predictions of the future.

## License

Apache 2.0