Welcome to the Lost Cities Game, featuring a cutting-edge AI opponent.

This AI is powered by advanced Reinforcement Learning (PPO) with a bespoke reward function, designed to elevate your gaming experience.

Game Rules

Game Snapshots

Currently it sucks at the game. The AI is still in training. Will update the README when it gets better.

Launching the Project

1. Backend Repository Setup
   Begin by cloning the backend repository from GitHub:
   Lost Cities RL Backend

2. Virtual Environment & Dependencies
   Set up a virtual environment, activate it, and install the necessary dependencies:

   python -m venv venv
   source venv/bin/activate 
   # On Windows: . venv\Scripts\activate
   pip install -r requirements.txt

3. Initiate the Backend Server
   Fire up the backend server with the command:

   uvicorn app.main:app --reload --port 8080

4. Frontend Repository Setup
   Clone the frontend repository from GitHub:
   Lost Cities RL Frontend

5. Frontend Dependencies Installation
   Navigate to the frontend directory and install all dependencies:

   yarn install

6. Launch the Frontend Server
   Start the frontend server using:

   yarn dev

7. Experience the Game
   Dive into the game by visiting:
   http://localhost:3000/