👻 GhostGPT - Your Haunted AI Assistant

Kiroween Hackathon 2024 - Frankenstein Category

GhostGPT is an AI-powered ghost assistant that fuses multiple technologies into one spooky, unified experience. Like Dr. Frankenstein's creature, it's assembled from disparate parts to create something greater than the sum of its components.

🎃 Features

👤 Possession Mode

Transform your mundane text into spine-chilling, ghostly prose. GhostGPT possesses your words and rewrites them with supernatural flair, adding eerie metaphors and otherworldly descriptions.

📚 Séance Mode

Channel knowledge from the spirit realm. Upload documents and GhostGPT will retrieve information using WebAssembly-powered search, presenting answers as mystical wisdom from beyond the veil.

⚡ Haunted Fusion (Frankenstein Feature)

Merge two files into one unified creation. Like Dr. Frankenstein assembling his creature, this mode intelligently combines code or text files, detecting patterns and preserving functionality.

🧪 The Frankenstein Elements

GhostGPT embodies the Frankenstein category by fusing:

1. Technologies: Next.js + OpenAI + WebAssembly + MCP Tools + Framer Motion
2. Paradigms: Cloud AI + Local inference + Vector search + External integrations
3. Concepts: Serious AI functionality + Playful horror theme + Multiple interaction modes

🚀 Installation

Prerequisites

• Node.js 18 or higher
• npm or yarn
• OpenAI API key (optional - graceful degradation included)

Setup Steps

1. Clone the repository

git clone <repository-url>
cd ghostgpt

2. Install dependencies

npm install

3. Configure environment variables

cp .env.example .env

Edit .env and add your OpenAI API key:

OPENAI_API_KEY=your_api_key_here

Note: The app works without an API key but will show demo responses.

4. Run the development server

npm run dev

5. Open your browser Navigate to http://localhost:3000

🎨 Tech Stack

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS with custom ghost theme
• Animations: Framer Motion
• AI: OpenAI GPT-3.5-turbo
• Retrieval: Custom WebAssembly-based engine
• Tools: MCP (Model Context Protocol) integration

🔮 Usage

Possession Mode

1. Select "Possession Mode" from the mode selector
2. Type any text you want to spookify
3. Watch as GhostGPT transforms it into haunted prose

Séance Mode

1. Select "Séance Mode"
2. Ask questions or request knowledge
3. Receive mystical wisdom from the spirit realm

Haunted Fusion

1. Select "Haunted Fusion"
2. Provide two code snippets or text passages
3. GhostGPT merges them intelligently

🛠️ Development with Kiro

Vibe Coding

GhostGPT was built using "vibe coding" - maintaining a consistent spooky aesthetic throughout:

• Theatrical variable names and comments
• Ghost-themed color palette
• Haunted animations and effects
• Playful horror tone in all interactions

Spec-Driven Development

The project follows a structured spec (.kiro/main.spec) that breaks development into phases:

1. Foundation (project setup)
2. Core Components (UI building blocks)
3. AI Integration (OpenAI connection)
4. Advanced Features (MCP tools, retrieval, fusion)
5. Polish (final touches)

Steering Guidelines

Two steering files guide development:

• frankenstein-category.md: Ensures Frankenstein theme adherence
• ghostgpt-guidelines.md: Maintains code style and ghost aesthetic

Agent Hooks

Two automated hooks enhance development:

1. Auto-test on Save: Runs TypeScript checking when files are saved
2. Generate Ghost Component: Creates new components with proper ghost styling

📁 Project Structure

ghostgpt/
├── app/
│   ├── api/chat/          # OpenAI API route
│   ├── globals.css        # Ghost theme styles
│   ├── layout.tsx         # Root layout
│   └── page.tsx           # Main page
├── components/
│   ├── ChatInterface.tsx  # Chat UI
│   ├── GhostHeader.tsx    # Animated header
│   └── ModeSelector.tsx   # Mode switching
├── lib/
│   ├── fusion.ts          # File merging logic
│   ├── mcp-tools.ts       # MCP integrations
│   └── retrieval.ts       # WebAssembly search
├── .kiro/
│   ├── hooks/             # Automation hooks
│   ├── steering/          # Development guidelines
│   └── main.spec          # Project specification
└── package.json

🎭 Why Frankenstein Category?

GhostGPT perfectly embodies the Frankenstein spirit:

1. Assembled from Parts: Combines Next.js, OpenAI, WebAssembly, MCP tools, and Framer Motion
2. Greater Than the Sum: Creates a unified experience from disparate technologies
3. Meta-Frankenstein: The "Haunted Fusion" feature literally merges files
4. Unexpected Combination: Serious AI + Horror theme = Delightfully spooky

🏆 Hackathon Submission

Category: Frankenstein
Theme: Kiroween 2024
Innovation: Multi-technology fusion with ghost theme
Technical Complexity: High (5 major technologies integrated)
Usability: Accessible and fun despite complexity

📝 License

MIT License - Feel free to fork and create your own haunted creations!

👥 Credits

Built with ❤️ and 👻 for the Kiroween Hackathon using Kiro IDE.

---

"It's alive! ALIVE!" - Dr. Frankenstein (probably talking about GhostGPT)