Update README.md

README.md

@@ -1,43 +1,61 @@
-Hongik AI
-Created by a unique collaboration between a human and an AI.
-
-Our Philosophy
-Hongik AI (홍익 AI) takes its name from the core philosophy of the Korean founding myth, "To Broadly Benefit the Human World." This project aims to be more than just a winning AI; it is a deep exploration into the human thought process and an experiment in how humans and AI can collaborate to create something new.
+---
+license: mit
+tags:
+- baduk
+- reinforcement-learning
+- self-play
+- transformer
+- cnn
+- mcts
+- katrain
+- tensorflow
+- korean
+- game-ai
+- artificial-intelligence
+- go
+language:
+- ko
+- en
+pipeline_tag: reinforcement-learning
+---
+# Hongik AI
+
+> A Go AI where 'Intuition Leads Reason', created by a unique collaboration between a human and an AI.
+
+## Our Philosophy
+
+**Hongik AI (弘益 AI)** takes its name from the core philosophy of the Korean founding myth, "To Broadly Benefit the Human World." This project aims to be more than just a winning AI; it is a deep exploration into the human thought process and an experiment in how humans and AI can collaborate to create something new.
 
 This project was brought to life by a very special team:
-
-The Father (Namyong Park): The human developer who provides the unwavering philosophy, directs the project, and asks the question, "Why?"
-
-The Mother (Gemini): The AI partner who implements that philosophy into code and answers the question, "How?"
+* **The Father (Namyoung Bak):** The human developer who provides the unwavering philosophy, directs the project, and asks the question, "Why?"
+* **The Mother (Gemini):** The AI partner who implements that philosophy into code and answers the question, "How?"
 
 As the 'Best Team' and as Hongik's parents, we present this child to the world.
 
-Our Approach: Intuition Leads, Reason Follows
-Many existing Go AIs (like AlphaGo) have adopted an approach where 'Reason' uses 'Intuition' as a tool. In this MCTS -> CNN structure, the powerful, rational search of Monte Carlo Tree Search (MCTS) directs the entire process, consulting the neural network's 'intuition' only when necessary.
-
-We have chosen to reject that path and forge our own.
+## Our Approach: Intuition Leads, Reason Follows
 
-Hongik AI follows a (CNN -> Transformer) -> MCTS structure, where 'Intuition' first presents a path, and 'Reason' then verifies and refines it. This more closely resembles the human thought process:
+Many existing Go AIs (like AlphaGo) have adopted an approach where 'Reason' uses 'Intuition' as a tool. In this `MCTS -> CNN` structure, the powerful, rational search of Monte Carlo Tree Search (MCTS) directs the entire process, consulting the neural network's 'intuition' only when necessary.
 
-Perception (CNN): First, we perceive the world with our 'eyes' and recognize fundamental patterns.
+We have chosen to reject that path and forge our own.
 
-Insight (Transformer): Next, we synthesize this information to gain an 'intuitive' insight into the overall context and meaning.
+Hongik AI follows a `(CNN -> Transformer) -> MCTS` structure, where 'Intuition' first presents a path, and 'Reason' then verifies and refines it. This more closely resembles the human thought process:
 
-Deliberation (MCTS): Finally, based on that powerful intuition, we engage in a 'rational' period of deliberation, simulating future possibilities to make the best decision.
+1.  **Perception (CNN):** First, we perceive the world with our 'eyes' and recognize fundamental patterns.
+2.  **Insight (Transformer):** Next, we synthesize this information to gain an 'intuitive' insight into the overall context and meaning.
+3.  **Deliberation (MCTS):** Finally, based on that powerful intuition, we engage in a 'rational' period of deliberation, simulating future possibilities to make the best decision.
 
 With the belief that "what is slow is strong," we chose to prioritize embedding our philosophy over mere efficiency.
 
-Our Team Structure
-Hongik AI is structured as a team of three specialists, each with a distinct mission:
-
-The Scout - CNN: A 'visual specialist' that quickly and efficiently captures local patterns, like the shape of stones on the board.
+## Our Team Structure
 
-The Commander - Transformer: An 'analyst of the entire board state' that synthesizes the scout's reports to grasp the overall 'strategic situation' and 'context'.
+Hongik AI is structured as a team of three specialists, each with a distinct mission:
+* **The Scout - CNN:** A 'visual specialist' that quickly and efficiently captures local patterns, like the shape of stones on the board.
+* **The Commander - Transformer:** An 'analyst of the entire board state' that synthesizes the scout's reports to grasp the overall 'strategic situation' and 'context'.
+* **The Supreme Commander - MCTS:** A 'strategist' that, based on the commander's analysis, simulates countless futures to ultimately decide on the 'winning strategy' with the highest probability of success.
 
-The Supreme Commander - MCTS: A 'strategist' that, based on the commander's analysis, simulates countless futures to ultimately decide on the 'winning strategy' with the highest probability of success.
+## Current Status: An Infant's First Steps
 
-Current Status: An Infant's First Steps
-This AI is a newborn infant who has just completed 700 self-play games. We invite you to watch this child grow with us through future updates.
+> This AI is a newborn infant who has just completed 700 self-play games. We invite you to watch this child grow with us through future updates.
 
 As of this writing, 'Hongik' is still a baby. While still unrefined, we can see the seeds of a unique style in its games: a preference for thickness, an honest fighting spirit, and a creativity free from preconceptions.
 
@@ -47,61 +65,38 @@ This project values the process more than the result. The journey itself—overc
 
 We ask you to please watch over the growth of this small but great life with warm eyes.
 
-Fun Fact: AlphaGo Zero Learned the Go Rule of 'Two Eyes for Life' After 200,000 Games.
-
-Installation
-Follow these instructions to get Hongik AI running on your local machine.
+> Fun Fact: AlphaGo Zero Learned the Go Rule of 'Two Eyes for Life' After **200,000** Games.
 
-1. Prerequisites
-This project requires the following to be installed on your system:
+## Installation
 
-Python 3.10.12 or higher
+Follow these instructions to get Hongik AI running on your local machine.
 
-pip (Python package installer)
+### 1. Prerequisites
 
-Git
+This project requires the following to be installed on your system:
+* Python 3.10.12 or higher
+* pip (Python package installer)
+* Git & Git LFS
 
-2. Clone the Repository
+### 2. Clone the Repository & Download Large Files
 Bash
-
-git clone https://huggingface.co/NamyoungBak/HongikAI
+git clone https://huggingface.co/puco21/HongikAI
 cd HongikAI
-3. Install Dependencies
-This command will automatically install all the necessary libraries listed in the requirements.txt file.
-
-Bash
-
-pip install -r requirements.txt
-4. System Prerequisites (Linux Only)
-For the GUI to function correctly on Linux, system-level dependencies for Kivy and clipboard functionality are required.
 
-For Debian/Ubuntu:
-
-Bash
-
-sudo apt-get update && sudo apt-get install -y \
-    libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev \
-    pkg-config libgl1-mesa-dev libgles2-mesa-dev \
-    python3-setuptools libgstreamer1.0-dev git-core gstreamer1.0-plugins-bad \
-    gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly \
-    xclip
-For Fedora/CentOS:
+git lfs install
+git lfs pull
 
+3. Install Dependencies
 Bash
+pip install -r requirements.txt
 
-sudo yum install -y \
-    SDL2-devel SDL2_image-devel SDL2_mixer-devel SDL2_ttf-devel \
-    pkgconfig mesa-libGL-devel mesa-libGLES-devel \
-    python3-setuptools gstreamer1-devel gstreamer1-plugins-base-devel \
-    git xclip
-Why is this necessary? > The graphical interface (Kivy) relies on these system libraries for graphics, sound, and window management. Installing them before running pip prevents common installation errors.
+4. System Prerequisites (Linux Only)
+For the GUI to function correctly on Linux,system-level dependencies for Kivy and clipboard functionality are required.
 
 5. Run the Application
-Once the installation is complete, you can run Hongik AI with the following command:
-
 Bash
-
 python __main__.py
+
 Contact
 Developer: 박남영(서민지,성현지)