SportsScribe-AI

SportsScribe-AI is an advanced AI-powered platform designed to revolutionize cricket journalism. It automates the creation of professional cricket match reports and generates dynamic audio narrations—making it the ultimate toolkit for sports journalists, bloggers, and cricket enthusiasts.

Web Interface

🚀 Key Features

🏏 AI-Powered Cricket Report Generation

Instantly generate comprehensive, professional-quality cricket match reports using advanced AI models.
Supports all major cricket formats: Test, ODI, T20, and IPL.
Reports include match summaries, turning points, player highlights, expert analysis and player statistics.

📝 Export & Share Reports

Download reports in DOCX formats, ready for publication or sharing.
Professionally formatted for easy integration into blogs, news portals, and print media.

🎙️ Sporty Narrative Voiceover

Convert generated reports into high-energy, commentary-style audio narrations.
Perfect for podcasts, reels, and automated voiceovers.
Highlights key moments and player performances with dynamic narration.

🌐 Modern Web Interface

Built with Next.js and Tailwind CSS for a fast, responsive, and visually appealing experience.
Intuitive UI for generating, previewing, and downloading reports and audio.

Some Sample Reports along with the query and their Audio narration

🗂️ Project Structure

SportsScribe-AI/
├── agents/
│   ├── FinalDrafter.py
│   ├── GetMatchDetails.py
│   ├── GetPlayerStats.py
│   ├── Getting_IDs.py
│   ├── report_narration.py
│   ├── ReportSavingAgent.py
│   ├── server.py
│   ├── SportsJournalist.py
│   └── WebAgent.py
├── ui/
│   ├── app/                   # Next.js app directory (pages, routes)
│   ├── components/            # React components (Navbar, UI, etc.)
│   ├── public/                # Static assets
│   ├── styles/                # Tailwind and global CSS
│   ├── package.json           # Frontend dependencies
│   ├── tailwind.config.js
│   ├── postcss.config.js
│   └── ...                    # Other config files, 
├── requirements.txt           # Python dependencies
├── README.md                  # Project documentation
├── .gitignore
└── ...                        # Misc files (.env, etc.)

⚡ Getting Started

Prerequisites

Python 3.10+
Node.js 18+ and npm (or pnpm)
ffmpeg (for audio narration)

1. Backend Setup (FastAPI)

pip install -r requirements.txt
cd agents
python server.py

Backend runs at http://127.0.0.1:8000

2. Frontend Setup (Next.js)

cd ui
npm install --legacy-peer-deps
npm run dev

Frontend runs at http://localhost:3000

3. Set up the enviornment Variables

Create a .env file in the root directory

GROQ_API_KEY= <YOUR_GROQ_API_KEY> 
GOOGLE_API_KEY= <YOUR_GEMINI_API_KEY>
TAVILY_API_KEY= <YOUR_TAVILY_API_KEY>
X-RAPID-API-KEY= <YOUR_X_RAPID_API_KEY>
X-RAPID-API-HOST= <YOUR_X_RAPID_API_HOST>
GOOGLE_MODEL1= <GOOGLE_LLM_MODEL_OF_YOUR CHOICE>
GOOGLE_MODEL2 = <GOOGLE_LLM_MODEL_OF_YOUR CHOICE>