Skip to content

drewM33/grok-mind-reader

Repository files navigation

GROK PSY OP :: Matrix Neural Interface

Real-time Matrix-themed visualization for xAI Grok interactions

Live neural interface that visualizes Grok's responses with cyberpunk aesthetics and real-time brainwave activity.

⚡ Quick Start

git clone https://github.com/yourusername/grok-psy-op.git
cd grok-psy-op
pip install aiohttp aiohttp-cors python-dotenv
export XAI_API_KEY='your-xai-key'
python grok_mind_cyber_matrix.py
# Open browser to http://localhost:8080

What It Does

  • Real-time Brainwave Visualization: Neural activity that reacts to token usage
  • Matrix Digital Rain: Animated background with Japanese characters
  • Live Token Tracking: Real-time prompt/output/cache metrics
  • WebSocket Updates: Instant UI updates without refresh
  • Grok API Integration: Direct connection to xAI's grok-2 model
  • Cyberpunk Aesthetics: Glitch effects, neon colors, flickering status

🖥️ Features

  • Neural Activity Monitor: Visual brainwave that spikes from green to pink during API calls
  • Timeline Tracking: Real-time log of all API calls
  • Token Statistics: Live tracking of prompt, output, think, and cache tokens
  • Matrix Rain Effect: Authentic Matrix-style falling characters
  • Responsive Design: Full-screen terminal aesthetic

🛠️ Tech Stack

  • Backend: Python, aiohttp, WebSockets
  • Frontend: Vanilla JS, Canvas API, CSS animations
  • API: xAI Grok API (grok-2 model)
  • Real-time: WebSocket bidirectional communication

📚 Project Structure

grok-psy-op/
├── grok_mind_cyber_matrix.py  # Main server + embedded UI
├── grok_api.py                 # xAI API integration
├── .env                        # API keys (not in repo)
└── README.md                   # You are here

🌍 Why This Matters

While xAI's API is powerful, visualizing AI interactions helps users understand:

  • Real-time processing patterns
  • Token usage and efficiency
  • The "thinking" process through visual metaphors
  • Making AI interactions more engaging and accessible

About

Real-time observability for xAI's agentic workflows

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors