Prof. Warlock

What I Built

Greetings, fellow innovators and Postmark Challengers! I'm back for a second round of inbox magic. After my first dive into this challenge, I was still captivated by the idea of email doing more—becoming a direct, almost personal gateway to cool services. That spark ignited my second project, and now it's back, more powerful than ever: Prof. Warlock 🔮.

Imagine a dedicated warlock and enthusiastic artist, sitting at their computer, eagerly awaiting your email. You send over some basic birth details in plain English, and through Prof. Warlock, they craft a magical, artistic natal chart poster just for you. That's the kind of direct, personal interaction I envisioned!

Forget wrestling with web forms or yet another app download. With Prof. Warlock, it’s just you, your email, and a touch of AI wizardry. In return? A beautiful, detailed, and A3-sized natal chart poster, ready to go, just like the one in the attached image.

This project is a living testament to how inbound email processing, especially with a service like Postmark, can power innovative applications that feel incredibly natural to use.

Key Features (The Magic Inside):

• AI-Powered Email Parsing: Now fully unleashed! Running on Google Cloud, a powerful BERT model understands natural, conversational language. No more rigid formats. Just write an email.
• Artistic & Detailed A3 Natal Charts: Professional, monochrome, and a completely custom layout (2480x3508px) for a high-resolution, print-ready poster.
• ⚡ Near-Instant Processing: The automated AI parsing and chart generation pipeline gets your personalized poster to you in moments.
• Privacy-Focused: Your data is never stored. It's used only for the immediate processing of your request.
• Smart Geocoding: Automatically looks up location coordinates from place names.
• Intelligent Validation: Get helpful error messages if any information is missing or unclear.

Demo

Experience the Magic - It's Fully LIVE!

You can try Prof. Warlock yourself by sending an email to: [e-mail]

** How to Test (Just Chat with the AI):**

1. Compose an email. The subject line can be anything you like. In the body, just write out the birth details conversationally.

   For example:
   

   To: [e-mail]
   Subject: Chart Request
   
   Hey Professor,
   
   Could you please create a birth chart for John Doe? He was born in New York, USA, on March 21, 1990, around 12:00 PM.
   
   Thanks a bunch!
   

2. Hit Send!

3. Receive Your Chart: Within moments, you'll get a reply with your personalized A3 natal chart attached as a high-quality PNG.

4. Test Error Handling: Try sending incomplete information (e.g., forget the time or place) to see Prof. Warlock's intelligent validation in action.

Code Repository

Want to peek under the hood and see how the spells are cast? The complete source code, including the now-deployed AI parser, is available on GitHub.

GitHub Repository: Prof-Warlock

The repository includes:

• The full FastAPI backend implementation.
• The complete code for the AIParser that's powering the live demo.
• A comprehensive test suite covering all flows.
• Deployment configuration for Google Cloud.
• Detailed documentation and setup instructions.

How I Built It

The biggest technical challenge for Prof. Warlock was parsing the free-form nature of an email body. My initial attempt was held back by hosting limitations, but not anymore.

The Rise of the AI Parser:
The brain of the operation is the AIParser, which integrates a bert-base-multilingual-cased model from the Hugging Face transformers library. This AI flawlessly identifies and extracts entities (name, date, time, location) from conversational sentences. I overcame the initial memory limitations I faced by migrating the project to Google Cloud. This move unleashed Prof. Warlock's true potential, allowing the AI to run freely and making the user experience truly magical.

The Tech Stack (My Potion Ingredients):

• Backend Framework: FastAPI
• Email Processing: Postmark Inbound API (The star of the show!)
• AI Parsing: transformers and PyTorch
• Chart Generation: natal Python library
• Graphics & Layout: PIL (Pillow)
• Geocoding: geopy
• Deployment: Google Cloud

Postmark Integration Experience:
Working with Postmark's inbound processing was exceptionally smooth. It allowed me to focus entirely on the core application logic—like perfecting the AI parser—rather than wrestling with email server complexities.

Future Vision (The Next Incantations):

• AI-Powered Astrological Insights: Beyond just the chart, I plan to integrate a Large Language Model (LLM) to generate detailed, personalized interpretations of zodiac signs, planetary placements, and aspects based on the user's chart.
• Chart Customization via Email: Giving users options to customize their chart's appearance (colors, styles, symbols) via simple email commands would be a fantastic next step.

Now I turn the question over to you: If you were part of this, what other features would you add to Prof. Warlock? I'm genuinely curious to hear your ideas!