Skip to content

Muxd21/AI_RACE_CLEAN

Repository files navigation

🚀 Genesis Mission Control

AI-powered scientific intelligence dashboard tracking breakthroughs across 6 critical domains: Advanced Manufacturing, Biotechnology, Critical Materials, Nuclear Energy, Quantum Info Science, and Semiconductors.

✨ Features

  • 📊 Real-time Research Tracking: Pulls latest papers from arXiv daily
  • 🤖 AI Strategic Briefing: Daily analysis with macro trends, actionable insights, and predictions
  • 🌍 Bilingual Support: Full English and Arabic (RTL) support with instant toggling
  • 📈 Saudi TASI Integration: AI-driven connection between global research and Saudi stock market opportunities
  • 💾 Export Tools: One-click copy to clipboard or download briefings as Markdown
  • ⏱️ Mission Timeline: Countdown to critical milestones
  • 🏷️ Trending Keywords: Interactive hashtag generation for easy social sharing
  • 📱 PWA Support: Install as a mobile app
  • 🎨 Premium Design: Modern, animated UI with glassmorphism effects

🛠️ Setup

1. Add GitHub Secret

For the AI briefing to work, you need to add your OpenRouter API key as a GitHub Secret:

  1. Go to your repository: SettingsSecrets and variablesActions
  2. Click New repository secret
  3. Name: OPENROUTER_API_KEY
  4. Value: [YOUR_OPENROUTER_API_KEY_HERE]
  5. Click Add secret

2. Enable GitHub Pages

  1. Go to SettingsPages
  2. Under Source, select GitHub Actions
  3. The site will deploy automatically

3. Trigger First Deployment

  1. Go to Actions tab
  2. Select Daily Mission Update workflow
  3. Click Run workflowRun workflow

Your site will be live at: https://kaledh4.github.io/AI_RACE/

🔄 How It Works

  1. Daily at 06:00 UTC: GitHub Actions runs scraper.py
  2. Data Collection: Fetches latest papers from arXiv for all 6 domains
  3. AI Analysis: Sends data to OpenRouter (Grok-4.1-fast) for strategic briefing
  4. Auto-Deploy: Updates mission_data.json and redeploys to GitHub Pages

📁 File Structure

AI_RACE/
├── index.html          # Premium dashboard UI
├── scraper.py          # Data fetching + AI analysis
├── manifest.json       # PWA manifest
├── sw.js              # Service worker for offline support
├── mission_data.json  # Generated data (auto-updated daily)
└── .github/
    └── workflows/
        └── daily_update.yml  # Automation workflow

🎯 AI Briefing Sections

  • 🦅 Macro View: Big picture analysis across all domains
  • ⚡ Actionable Verdict: What to focus on immediately
  • � Saudi TASI Opportunities: Mapping global breakthroughs to local market leaders
  • 📈 Trend Analysis: Research activity patterns
  • 🔮 What to Expect Next: 30-90 day predictions
  • 🏷️ Trending Keywords: Top 10 hashtags for social monitoring
  • 🌍 Arabic Translation: Full native translation of the daily briefing

🚀 Local Development

# Install dependencies (Python 3.10+)
# No external dependencies needed - uses stdlib only!

# Run scraper locally
python scraper.py

# Serve locally
python -m http.server 8000
# Visit: http://localhost:8000

📊 Data Sources

  • arXiv API: Open access to 2M+ scientific papers
  • OpenRouter: AI analysis using x-ai/grok-4.1-fast:free

🔐 Security

  • API keys stored as GitHub Secrets (never committed)
  • Environment variables used in workflows
  • Fallback key for local development only

📱 Mobile Support

  • Fully responsive design
  • PWA-enabled for "Add to Home Screen"
  • Offline support via service worker
  • Optimized for touch interactions

🎨 Design Features

  • Animated grid background
  • Glassmorphism effects
  • Shimmer animations
  • Gradient accents
  • Dark mode optimized
  • Custom fonts (Space Grotesk + JetBrains Mono)

📄 License

Open source - feel free to fork and customize!

🤝 Contributing

This is a personal dashboard but feel free to:

  • Report issues
  • Suggest features
  • Fork and customize for your use case

⚖️ Legal Disclaimer

For Informational Purposes Only The "Stock Picks" and "Saudi TASI Opportunities" sections generated by this application are for demonstration and showcase purposes only. They are generated by an AI model based on semantic relevance to scientific research papers and do not constitute financial advice.

  • Do not trade based on these recommendations.
  • Always conduct your own due diligence.
  • The developers and creators of this project assume no liability for financial decisions made based on this data.

Built with ⚡ GitHub Actions | 🤖 OpenRouter AI | 📚 arXiv API

About

AI-powered scientific intelligence dashboard tracking breakthroughs across 6 critical domains: Advanced Manufacturing, Biotechnology, Critical Materials, Nuclear Energy, Quantum Info Science, and Semiconductors.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors