Tarot Reading API

A mystical tarot reading application powered by Django Ninja and PydanticAI. This project allows users to explore tarot cards, create readings, and generate AI-powered celestial insights for guidance.

---

Fast to learn, fast to code, fast to run

---

---

Features ✨

• Manage tarot suits and cards (Major and Minor Arcana).
• Create readings and add cards with positions, orientations, and interpretations.
• Generate AI-powered celestial insights using GPT-4 for tarot readings.

---

Installation Instructions 🔌

Prerequisites

• Python 3.12
• SQLite (default)
• uv package manager

---

1. Clone the Repository

git clone https://github.com/ElderEvil/celestial-insight.git
cd celestial-insight

---

2. Install requirements

uv virtualenv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install Dependencies

uv sync

4. Run Database Migrations

uv run python manage.py migrate

5. Start the Development Server

uv run python manage.py runserver

---

Roadmap 🚀

Current Features

• Manage tarot suits and cards.
• AI-powered celestial insights for readings.
• Localization for multi-language support.
• Filter cards and readings via API.

Planned Features

Enhanced Spread Logic:

• Support for more tarot spreads.
• Visual representation of card layouts.

User Personalization:

• Save favorite readings.
• Insights tailored to user history.

Advanced AI Integrations:

• Deeper GPT-4 interpretative insights.
• Generate custom spreads based on user input.

Deck Customization:

• Users can create and manage custom tarot decks.