v1.0.0 Release

Omi Card Game

A fully playable, AI-driven implementation of the Sri Lankan trick-taking card game.

⚡ Completed Tier 2 Project (October 2026).

~ About the Project

Omi is a traditional Sri Lankan trick-taking card game. This project is a complete, playable desktop application built entirely with Pygame, featuring a human player, an AI partner, and two AI opponents.

The game features an interactive trump-selection phase, dynamic scoring (including the 8-trick sweep and bonus round tie-breakers), and intelligent card-playing heuristics where the AI can recognize when its partner is winning a trick and play accordingly.

Roadmap: v1.0 is fully playable, but the codebase is currently undergoing a v2.0 refactor to improve the separation of concerns between the game logic, rendering engine, and AI heuristics.

~ Tech Stack & Architecture

Python Pygame OOP Event-Driven

~ How to Run

1. Clone the repo and install dependencies:

git clone https://github.com/Tharana-Dev/omi-card-game.git
cd omi-card-game
pip install pygame

2. Run the game:

python main.py

⚠️ Note: The game will run without audio or background images by default. To get the full experience, add your own image.png and .wav/.mp3 files to the root folder.

~ Download the Game

Download the source code directly, or view the repository on GitHub.

Download .zip ⬇ View Repo