Rocket League Replay Analysis with multiple AI agents (OpenAI, Anthropic, Gemini)

RattleBrain

RattleBrain is a command-line tool, written in Rust, designed to bring the power of AI providers to your Rocket League replay analysis. By leveraging Rattletrap for parsing replay files and connecting to one or more AI services (e.g., OpenAI, Anthropic, Google), RattleBrain extracts tactical insights, performance metrics, and actionable feedback to help you elevate your gameplay.

see the current examples/feedback.md for an example of generated output.

also see the current TODOs for upcoming features.

Usage

Download and Run the latest release of RattleBrain with a replay file

./rattlebrain analyze <replay_file>

Features

• AI-Enhanced Analysis: Analyze Rocket League replay files with the help of AI services for in-depth insights.
• Dynamic AI Selection: Automatically detects and configures available AI services via environment variables (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY).
• Unified Reporting: Combines outputs from multiple AI agents into a single, comprehensive report.
• Tactical Insights: Highlights key plays, strategic opportunities, and areas for improvement.
• Performance Metrics: Extracts useful data points to track your progress over time.
• Lightweight and Fast: Built with Rust for performance and efficiency.

Getting Started

Prerequisites

1. Install Rattletrap:

   • RattleBrain uses Rattletrap to parse replay files, and is automatically downloaded if not detected in $PATH.

2. Obtain API Keys:

   • Get API keys for the AI services you'd like to use (e.g., OpenAI, Gemini).

3. Set Environment Variables:

   • Add API keys to AI Services in environment variables (at least 1):

     export OPENAI_API_KEY=<