README.md

---
library_name: transformers
language:
- en
base_model:
- google/flan-t5-small
---

# Horoscope Personality Generator (English) 🌟

This is a fine-tuned version of [google/flan-t5-small](https://huggingface.co/google/flan-t5-small), trained on a small custom dataset for generating personality descriptions based on astrological birth chart inputs in English.

## 🧠 What does this model do?

Given a combination of Sun, Moon, and Venus signs, the model generates a natural-sounding English explanation of the personality traits commonly associated with that planetary arrangement.

### Example Input and Output:
'''Sun: Virgo, Moon: Capricorn, Venus: Libra'''
'''"You are analytical yet sociable, with an adventurous romantic spirit."'''

## 🔮 Try it out

Use the inference widget below to generate personality descriptions:


## 🚀 Use Cases
- Fun astrology apps or websites
- Horoscope personality matching
- Conversational chatbots with zodiac insights

## 🔧 Model Details
- Base model: `google/flan-t5-small`
- Language: English
- Training: Fine-tuned on 3-sign (Sun, Moon, Venus) astrology description pairs
- Domain: Modern Western Astrology
- Format: Sequence-to-sequence text generation

## 🔐 Limitations
This is a proof-of-concept model trained on a small dataset. The output should be interpreted as entertainment and not as scientifically validated personality profiling.

## 🤝 Contributions
This project is developed and maintained by [Your Name or Username].  
Feel free to fine-tune further or use this as a base for more personalized horoscope applications.

## 🗄️ Database (PostgreSQL)

This project uses **PostgreSQL** to store user input, birth chart data, and generated interpretations.

### 📦 Example table schema:

```sql
CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  username TEXT NOT NULL,
  birthdate DATE,
  birthtime TIME,
  birthplace TEXT
);

CREATE TABLE horoscopes (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  sun TEXT,
  moon TEXT,
  venus TEXT,
  interpretation TEXT
);
---