diff --git a/.gitignore b/.gitignore
index 3c3629e6..02025e92 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,4 @@
 node_modules
+# Old cowsay virtual environment, intentionally kept
+implement-cowsay/.venv  
+
diff --git a/laptop_allocation.py b/laptop_allocation.py
new file mode 100644
index 00000000..0a8cd688
--- /dev/null
+++ b/laptop_allocation.py
@@ -0,0 +1,84 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing import Dict, List
+
+# Define available operating systems
+class OperatingSystem(Enum):
+    MACOS = "macOS"
+    ARCH = "Arch Linux"
+    UBUNTU = "Ubuntu"
+
+
+@dataclass(frozen=True)
+class Person:
+    name: str
+    age: int
+    # Sorted in order of preference, most preferred is first.
+    preferred_operating_system: List[OperatingSystem]
+
+
+@dataclass(frozen=True)
+class Laptop:
+    id: int
+    manufacturer: str
+    model: str
+    screen_size_in_inches: float
+    operating_system: OperatingSystem
+
+# List of available laptops
+laptops = [
+    Laptop(id=1, manufacturer="Dell", model="XPS", screen_size_in_inches=13, operating_system=OperatingSystem.ARCH),
+    Laptop(id=2, manufacturer="Dell", model="XPS", screen_size_in_inches=15, operating_system=OperatingSystem.UBUNTU),
+    Laptop(id=3, manufacturer="Dell", model="XPS", screen_size_in_inches=15, operating_system=OperatingSystem.UBUNTU),
+    Laptop(id=4, manufacturer="Apple", model="macBook", screen_size_in_inches=13, operating_system=OperatingSystem.MACOS),
+    Laptop(id=5, manufacturer="Apple", model="macBook", screen_size_in_inches=13, operating_system=OperatingSystem.MACOS),
+    Laptop(id=6, manufacturer="Apple", model="macBook", screen_size_in_inches=13, operating_system=OperatingSystem.ARCH),
+] 
+
+# List of people to allocate laptops to
+people = [
+    Person(name="Imran", age=22, preferred_operating_system=[OperatingSystem.ARCH,OperatingSystem.UBUNTU]),
+    Person(name="Eliza", age=34, preferred_operating_system=[OperatingSystem.ARCH,OperatingSystem.MACOS,OperatingSystem.UBUNTU]),
+    Person(name="Leila", age=45, preferred_operating_system=[OperatingSystem.MACOS,OperatingSystem.UBUNTU,OperatingSystem.ARCH]),    
+    Person(name="Mary", age=35, preferred_operating_system=[OperatingSystem.MACOS,OperatingSystem.ARCH]),
+    Person(name="Sara", age=28, preferred_operating_system=[OperatingSystem.MACOS])
+]
+
+
+# Allocate laptops to people to minimize total sadness
+# NOTE: laptops list is modified on purpose.
+# After allocation, it shows the laptops that are still left.
+
+def allocate_laptops(people: List[Person], laptops: List[Laptop]) -> Dict[str, Laptop]: 
+    sorted_people_OS_count=sorted(people,key=lambda p:len(p.preferred_operating_system))
+    sadness=0  # local variable sadness counter
+    allocated_history : Dict[Person,Laptop] ={}
+    
+    for person in sorted_people_OS_count :
+     allocated_flag=False
+     for i in range(len(person.preferred_operating_system)) :
+          for laptop in laptops :
+              if person.preferred_operating_system[i] == laptop.operating_system :
+                  allocated_history[person.name]=laptop # assign laptop
+                  sadness += i  # increment sadness by preference index
+                  laptops.remove(laptop)
+                  allocated_flag=True
+                  break
+          if allocated_flag : 
+            break     
+          
+     if not allocated_flag :   # assign any remaining laptop if preferred OS not found
+        allocated_history[person.name]=laptops[0]
+        laptops.remove(laptops[0])
+        sadness +=100   # high sadness for non-preferred OS
+              
+    return allocated_history  , sadness        
+
+def print_final_allocation(allocated_history :dict[str,Laptop], sadness:int ) :
+    for name , laptop in allocated_history.items() :
+        print(f"{name:<10} : Laptop Id {laptop.id:<3} - OS({laptop.operating_system.name}) ")
+    print(f"Total sadness is : {sadness}")
+
+allocated_history, sadness = allocate_laptops(people, laptops)
+
+print_final_allocation(allocated_history, sadness)
\ No newline at end of file