Geli is a personal ranking app inspired by the Beli restaurant-rating experience. Search for any video game, book, movie, or TV show, rate it as Like, Neutral, or Dislike, then stack-rank it against your other picks through quick pairwise comparisons. Once you've ranked at least 10 items in a category, Geli automatically calculates a 1–10 score for every title on your list.

💡 Books use the Open Library API which requires no API key.

git clone https://github.com/NSC508/Geli.git
cd Geli

You can use Conda (recommended) or a plain virtualenv.

# Create and activate a new environment
conda create -n geli python=3.11 -y
conda activate geli

# Install dependencies
pip install flask requests

python3 -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate

pip install flask requests

1. Go to the Twitch Developer Console.
2. Log in (or create a free Twitch account).
3. Click Register Your Application.
4. Fill in:
   • Name: anything (e.g. Geli)
   • OAuth Redirect URLs: http://localhost
   • Category: Application Integration
5. Click Create, then click Manage on the new app.
6. Copy your Client ID.
7. Click New Secret and copy the Client Secret.

1. Go to TMDB and create a free account.
2. Go to Settings → API → Request an API Key.
3. Select Developer, accept the terms, and fill in the application details.
4. Copy your API Key (v3 auth).

Choose one of the two methods below. Environment variables are recommended because they keep secrets out of files entirely.

export IGDB_CLIENT_ID="your_client_id_here"
export IGDB_CLIENT_SECRET="your_client_secret_here"
export TMDB_API_KEY="your_tmdb_api_key_here"

cp creds.example.json creds.json

{
    "client_id": "your_twitch_client_id_here",
    "client_secret": "your_twitch_client_secret_here",
    "tmdb_api_key": "your_tmdb_api_key_here"
}

python app.py

The app will start on http://localhost:5000. Open this URL in your browser.

1. Switch Media — Click the Geli logo in the navbar to switch between Games, Books, Movies, and TV Shows.
2. Add Items — Click + Add Game/Book/Movie/Show in the navbar and search.
3. Rate It — Click a search result and choose Like, Neutral, or Dislike.
4. Compare — If there are other items in the same tier, you'll be asked "Which is better?" comparisons.
5. View Rankings — The home page shows your full ranked list, split by tier.
6. Scores Unlock at 10 Items — Once you've ranked 10+ items in a media type, numerical scores appear.
7. Remove — Click the ✕ button on any card to remove it from your rankings.

Geli/
├── app.py                  # Flask application — multi-media routes & API endpoints
├── igdb_client.py          # IGDB / Twitch API client (games)
├── openlibrary_client.py   # Open Library API client (books)
├── tmdb_client.py          # TMDB API client (movies & TV shows)
├── models.py               # SQLite data layer with media_type support
├── ranking.py              # Binary insertion ranking algorithm & score calculation
├── static/
│   ├── style.css           # Dark glassmorphism theme with per-media accents
│   └── app.js              # Client-side search, rating, comparison, media switcher
├── templates/
│   ├── base.html           # Base layout with navbar & media switcher dropdown
│   ├── index.html          # Rankings page (adaptive to media type)
│   ├── search.html         # Search & rating page (adaptive to media type)
│   └── compare.html        # Pairwise comparison page (adaptive to media type)
├── creds.example.json      # Template for API credentials
├── .gitignore              # Keeps secrets & DB out of version control
└── README.md               # You are here!

💡 Books use Open Library which requires no credentials at all.

Pull requests are welcome! If you have ideas for new features or find a bug:

1. Fork the repo
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is open source and available under the MIT License.

• Game data provided by IGDB via the Twitch API
• Book data provided by Open Library
• Movie & TV data provided by TMDB
• Inspired by Beli