Skip to content
@The-Gully

The Gully

Gully is a sophisticated application that allows you to query a rich database of Indian Premier League (IPL) cricket statistics using plain English.
Gully Logo

Gully

Because asking "How many wides did Pathirana bowl?" shouldn't require a CS degree

FastAPI ChatGroq Gin OAuth SQL LangGraph

Talk cricket. We'll handle the Data.


What is Gully?

Gully is your AI-powered cricket statistician that speaks plain English. No more wrestling with SQL queries or spreadsheets to answer burning IPL questions. Just ask naturally, and get instant answers from our comprehensive ball-by-ball database (2008-2025).

The Problem: You want to know obscure IPL stats, but SQL is about as readable as Jadeja's bowling action.

The Solution: Gully translates your cricket curiosity into lightning-fast database queries.

Example Queries

"How many sixes did Gayle hit in powerplays during IPL 2023?"
"Which bowler has the best economy rate at Wankhede?"
"What's Dhoni's strike rate in successful chases?"

Our Ecosystem

The brain of the operation

  • AI agent for natural language → SQL conversion
  • FastAPI backend with SQLAlchemy ORM
  • CLI tool for quick queries
  • Query optimization and caching

The orchestrator

  • High-performance Go-GIN REST API
  • Google OAuth authentication
  • PostgreSQL database management
  • User session & rate limiting

Under Active Development

Graph + IPL = Something amazing is cooking...


Key Features

Natural Language Processing

Ask questions like you're chatting with your cricket buddy, not a database admin.

Discord-Style Tagging

Use intuitive tags for consistency:

  • @players — MS Dhoni, Virat Kohli, AB de Villiers
  • @teams — Mumbai Indians, Chennai Super Kings
  • @venues — Wankhede Stadium, Eden Gardens
  • @umpires — Nitin Menon, Kumar Dharmasena
  • @cities — Mumbai, Bangalore, Kolkata

Tech Stack

Layer Technologies
Frontend React 18, Vite, TailwindCSS
Core Agent Python 3.8+, FastAPI, SQLAlchemy, Alembic
Backend Go 1.19+, GIN Framework, PostgreSQL
AI/ML LangChain, OpenAI/Anthropic APIs
Database PostgreSQL 14+ with full-text search
Auth Google OAuth 2.0
Deployment Docker, Kubernetes (coming soon)
---

Contributing

Looking for contributions SPECIFICALLY FOR FRONTEND We welcome contributions from cricket enthusiasts and developers alike! Whether you're fixing a typo or adding support for T20 World Cup data, we'd love your help.

Ways to Contribute:

  • Report bugs and issues
  • Suggest new features or query types
  • Improve documentation
  • Write tests
  • Design improvements
  • Submit pull requests

Fun Stats

Using Gully's own data, of course:

  • Total Deliveries Tracked: 278205
  • Players in Database: 778
  • Queries Processed: Growing daily

License

This project is licensed under the MIT License - see the LICENSE file for details.


Acknowledgments

  • Cricket data providers CricSheet for making this possible
  • Our contributors who make Gully better every day
  • The IPL for 17+ years of entertainment and memes
  • That one friend who always asks impossible cricket trivia

Made with care and an unhealthy obsession with cricket statistics

Star this repo if you love cricket as much as we do!

Back to Top

Pinned Loading

  1. the-gully the-gully Public

    Gully is a sophisticated application that allows you to query a rich database of Indian Premier League (IPL) cricket statistics using plain English. It leverages a powerful AI agent to understand n…

    Python 2

Repositories

Showing 4 of 4 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…