Oracle's Inversion

An immersive, Matrix-themed resume analyzer built for a hackathon. This web app uses the Google Gemini API to deconstruct your resume, identify weaknesses, and provide a detailed blueprint to help you escape the job application "Matrix."

---

---

✨ Key Features

• Immersive Thematic UI: A fully responsive interface inspired by The Matrix and Tenet, featuring an animated digital rain background, glitch effects, and a terminal aesthetic.
• AI-Powered Analysis: Leverages the Google Gemini API to provide deep, insightful feedback that goes far beyond simple grammar checks.
• Detailed Multi-Point Feedback: Generates a complete blueprint for improvement, including:
  • A rating out of 10.
  • Critical weaknesses ("System Vulnerabilities").
  • Actionable improvements ("Tactical Adjustments").
  • The projected impact of the changes.
  • A final summary on how to gain a competitive advantage.
• Interactive User Journey: The experience starts with the iconic "Red Pill / Blue Pill" choice, leading to a dynamic, scrollable single-page application.
• Animated Content Grid: A detailed "About" section with a 2x2 grid that animates into view as the user scrolls.

---

🛠️ Technology Stack

• Frontend:
  • HTML5
  • CSS3 (Flexbox, CSS Grid, Animations)
  • Vanilla JavaScript (ES6+, Fetch API, Intersection Observer)
• Backend:
  • Python 3
  • Flask (for the web server and API)
• AI & Data Processing:
  • Google Gemini API (for the core resume analysis)
  • PyMuPDF (for efficient PDF text extraction)

---

🚀 Setup and Installation

To run this project locally, follow these steps:

1. Clone the repository:

   git clone [https://github.com/your-username/oracles_inversion.git](https://github.com/your-username/oracles_inversion.git)
   cd oracles_inversion

2. Create and activate a virtual environment:

   # For Windows
   python -m venv venv
   venv\Scripts\activate
   
   # For macOS/Linux
   python3 -m venv venv
   source venv/bin/activate

3. Install the required dependencies:

   pip install -r requirements.txt

4. Set up your Environment Variables:

   • Create a file named .env in the root directory of the project.
   • Add your Google Gemini API key to this file:

     GEMINI_API_KEY="YOUR_API_KEY_HERE"
     

5. Run the Flask application:

   python app.py

6. Access the application:

   • Open your web browser and navigate to http://127.0.0.1:5000.

---

📖 How to Use

1. Upon landing on the page, you're presented with the choice. Click "Take the Red Pill" to begin.
2. The page will automatically scroll down to the terminal interface.
3. Click "Choose Construct..." to upload your resume. It must be a text-based PDF file.
4. Click "Initiate" and wait for the Oracle to perform its analysis.
5. Review your detailed feedback blueprint in the terminal.
6. You can scroll down further to read about the project's mission and technology in the animated grid.