Nolan-Verse: The Architect AI

Nolan-Verse is an immersive chatbot experience powered by the Google Gemini API. It's designed to guide users through their emotions by creating a unique, cinematic world in the style of director Christopher Nolan.

You are not just chatting; you are engaging with 'The Architect,' an AI that helps you reframe your perspective on daily challenges through powerful, narrative-driven metaphor. Based on your feelings, it builds a personalized scene, grounds you in the present, and recommends a Nolan film that resonates with your experience, offering insights for personal growth.

Features

• Immersive Storytelling: Engages users in a dynamic, evolving narrative based on their feelings.
• Cinematic World-Building: Creates vivid, atmospheric scenes inspired by Christopher Nolan's signature style.
• Empathetic AI Persona: Interacts as 'The Architect,' a wise guide for introspection.
• Personalized Movie Recommendations: Suggests a Nolan film tailored to the user's emotional state, complete with an insightful justification.
• Real-time Streaming: AI responses are streamed to the user for a fluid, natural conversation.
• Visually Appealing UI: A sleek, dark-themed interface with subtle animations to enhance the cinematic feel.

Tech Stack

• Frontend: React, TypeScript, Tailwind CSS
• AI: Google Gemini API (@google/genai)
• Environment: AI Studio

Getting Started

This project is designed to run in an environment where the Google Gemini API key is provided as an environment variable (process.env.API_KEY).

Prerequisites

• Access to the Google Gemini API.
• An environment (like AI Studio) that securely manages and provides the API key.

Running the Application

1. Ensure all project files are in their correct directories as structured in this repository.
2. If running locally, create a .env file in the root directory and add your API key:

   API_KEY=YOUR_GEMINI_API_KEY
   

3. Serve the public/index.html file through a local web server.

How to Contribute

Contributions are welcome! If you have ideas for new features, improvements to the AI's persona, or UI enhancements, please feel free to fork the repository and submit a pull request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

Built with passion for storytelling and AI.