� Geisha Gains — War Room

Brutalist Intelligence-Driven Crypto Trading Simulator

🎯 A production-ready AI-powered crypto trading simulator that successfully demonstrated NVIDIA NIM integration at BugsByte 2026!

🌐 View Live Demo • 🐛 Report Bug • ✨ Request Feature

---

🏯 Geisha Gains — War Room Dashboard

---

👨‍💻 About the Developer

Hi, I'm a Full-Stack Developer specializing in AI-powered applications and real-time systems.

This crypto trading simulator was built for BugsByte 2026 Hackathon, featuring a complete intelligence loop with NVIDIA NIM AI integration, demonstrating advanced news analysis and risk profiling capabilities.

If you're a recruiter or collaborator, feel free to reach out:

---

🧠 Features

• 🏯 Brutalist Design — Dark theme with red accents and monospace fonts
• 🤖 NVIDIA NIM Integration — Llama-3 70B AI for news analysis
• 📰 Real-time News Analysis — Live crypto news API with intelligent filtering
• 👤 User Profiling — Terminal-style onboarding capturing trading psychology
• 📊 War Room Dashboard — Multi-panel intelligence display
• 🎯 Threat Radar — 4-axis visualization of market risks
• ⚡ Action Overlays — Lethal alerts with QUICK SELL functionality
• ☕ Coffee Driven Development — Built with passion and caffeine
• 🔄 Intelligence Loop — Continuous news analysis against user profile

---

📦 Tech Stack

---

🛠 Installation & Setup

Prerequisites

Make sure you have the following installed:

• Node.js (v18.0.0 or higher)
• npm or yarn package manager
• Git
• PostgreSQL (optional, SQLite works for demos)

Quick Start

# 1️⃣ Clone the repository
git clone https://github.com/YOUR_USERNAME/geisha-gains.git

# 2️⃣ Navigate to the project directory
cd geisha-gains

# 3️⃣ Install dependencies
npm install

# 4️⃣ Set up environment variables
cp .env.example .env
# Edit .env with your NVIDIA API key and database URL

# 5️⃣ Initialize database
npm run db:generate
npm run db:push

# 6️⃣ Start the development server
npm run dev

🎉 That's it! Open http://localhost:3000 to begin The Interrogation!

Environment Variables

Create a .env file with:

# Database (SQLite for quick start, PostgreSQL for production)
DATABASE_URL="file:./dev.db"

# NVIDIA NIM API (required for AI analysis)
NVIDIA_NIM_ENDPOINT="https://integrate.api.nvidia.com/v1/chat/completions"
NVIDIA_API_KEY="nvapi-YOUR-KEY-HERE"

Build for Production

# Create optimized production build
npm run build

# Start production server
npm start

Database Management

# View database in browser
npm run db:studio

# Reset database (WARNING: Deletes all data)
npx prisma migrate reset

---

🧗‍♂️ Project Structure

geisha-gains/
├── 📁 app/
│   ├── 📁 api/
│   │   └── 📁 news/
│   │       └── 📁 analyze/
│   │           └── route.ts          # NVIDIA NIM news analysis endpoint
│   ├── 📁 components/
│   │   ├── 📁 dashboard/
│   │   │   ├── ActionOverlay.tsx     # Lethal alert overlays
│   │   │   ├── TheBulletin.tsx       # News feed with threat colors
│   │   │   └── ThreatRadar.tsx       # 4-axis risk visualization
│   │   └── 📁 onboarding/
│   │       └── TheInterrogation.tsx  # Terminal-style profiling
│   ├── 📁 dashboard/
│   │   └── page.tsx                  # War Room dashboard
│   ├── error.tsx                     # Error boundary component
│   ├── global-error.tsx              # Global error handler
│   ├── globals.css                   # Brutalist styling
│   ├── layout.tsx                    # Root layout
│   └── page.tsx                      # Home (onboarding flow)
├── 📁 lib/
│   └── newsService.ts                # Live news API integration
├── 📁 prisma/
│   └── schema.prisma                 # Database schema
├── 📁 public/
│   └── 📁 assets/
│       └── 📁 logo1.ico              # App favicon
├── components.json                   # shadcn/ui config
├── jsconfig.json                     # JavaScript configuration
├── next.config.js                    # Next.js configuration
├── package.json                      # Dependencies & scripts
├── postcss.config.js                 # PostCSS configuration
├── tailwind.config.js                # Tailwind CSS configuration
├── SETUP_GUIDE.md                    # Detailed setup instructions
└── README.md                         # You are here! 📍

---

🎯 How It Works

The Intelligence Loop

1. The Interrogation — Terminal-style onboarding captures trading psychology

2. Risk Profiling — Stores profile in localStorage with 4 key dimensions:

   • Risk Tolerance (CONSERVATIVE/MODERATE/AGGRESSIVE)
   • Investment Horizon (SCALP/SWING/POSITION)
   • Focus Sectors (CRYPTO/STOCKS/FOREX/COMMODITIES)
   • Geopolitical Sensitivity (IGNORE/AWARE/PARANOID)

3. News Intelligence — Fetches crypto news from live news API

4. AI Analysis — NVIDIA NIM Llama-3 70B analyzes news against user profile

5. War Room Dashboard — Real-time threat assessment and action alerts

Key Components

• TheBulletin: Vertical news feed with threat-colored borders
• ThreatRadar: 4-axis SVG radar (Volatility, Geopolitics, Sentiment, Exposure)
• ActionOverlay: Fixed-position lethal alerts with QUICK SELL buttons
• News Analysis API: Returns global_score, portfolio_threat, sentiment, action, reasoning

---

🛣 Roadmap

• � Brutalist dark theme with red accents
• 👤 Terminal-style user profiling (The Interrogation)
• 🤖 NVIDIA NIM Llama-3 70B integration
• 📰 Live news API ingestion
• 📊 War Room dashboard with multi-panel display
• 🎯 Threat Radar 4-axis visualization
• ⚡ Action Overlay lethal alerts
• ☕ Coffee Driven Development branding
• 🔄 Intelligence loop with continuous analysis
• 📱 Fully responsive design
• 🎨 Framer Motion animations
• 🗄️ Prisma ORM with PostgreSQL/SQLite
• 🌙 Dark/Light mode toggle
• 📈 Real trading integration (Uphold API)
• 🔄 WebSocket real-time updates
• 📊 Advanced analytics dashboard
• 🎫 Portfolio export functionality

---

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

How to Contribute

1. Fork the Project

   # Click the 'Fork' button at the top right of this page

2. Clone your Fork

   git clone https://github.com/YOUR_USERNAME/geisha-gains.git

3. Create a Feature Branch

   git checkout -b feature/AmazingFeature

4. Make your Changes

   # Code your amazing feature

5. Commit your Changes

   git commit -m "Add: AmazingFeature"

6. Push to the Branch

   git push origin feature/AmazingFeature

7. Open a Pull Request

   # Go to your fork on GitHub and click 'New Pull Request'

Contribution Guidelines

• 📝 Write clear, concise commit messages
• 🧪 Test your changes thoroughly
• 📖 Update documentation if needed
• 🎨 Follow the existing brutalist code style

---

⭐ Support This Project

If you found this project helpful or inspiring, please consider giving it a ⭐!

Your support helps the project grow and motivates continued development.

Every star counts! Thank you for your support! 🙏

---

📝 License

Distributed under the MIT License. See LICENSE for more information.

MIT License

Copyright (c) 2026 Geisha Gains

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...

---

🏯 Built with ☕ by Coffee Driven Development

Geisha Gains — Where Intelligence Meets the Markets 🏯💹