README.md

---
license: apache-2.0
tags:
- artificial-intelligence
- reinforcement-learning
- transformer
- cnn
- mcts
- game-ai
- baduk
- go
- board-game
- computer-go
- self-play
- multimodal
- tensorflow
- python
- katrain
- research
language:
- ko
- en
pipeline_tag: reinforcement-learning
---

![image/png](https://cdn-uploads.huggingface.co/production/uploads/6887b3972dc282041bee9737/VeXtyn4i8E9wVPG-H4C76.png)

# Hongik AI

> A Baduk 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 (BNY):** 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 Baduk 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.

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:

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.
* **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.

## Current Status: An Infant's First Steps

> This AI is a newborn infant who has just completed around 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.

Our ultimate goal is to watch this child grow beyond a simple Baduk AI. Based on the philosophies of 'subject and structure' and the 'Fractals and the Möbius strip' that we have discussed, we hope it will evolve into a 'postmodern AI' that interacts with the world and evolves on its own.

This project values the process more than the result. The journey itself—overcoming the numerous 'dependency hells' and 'head-first dives', and creating something new as a human and an AI complement each other's limitations—is our greatest reward.

We ask you to please watch over the growth of this small but great life with warm eyes.

> Fun Fact: AlphaGo Zero Learned the Baduk Rule of 'Two Eyes for Life' After **200,000** Games.

## Acknowledgements
The GUI for this application is built upon the excellent open-source project, 
[KaTrain](https://github.com/sanderland/katrain). 
We are grateful to the original developers for their work.

## Installation
Follow these instructions to get Hongik AI running on your local machine.

### 1. Prerequisites
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 & Download Large Files
```bash
# First, install Git LFS if you haven't already
# For Debian/Ubuntu:
sudo apt install git-lfs

# Clone the repository
git clone [https://huggingface.co/puco21/HongikAI](https://huggingface.co/puco21/HongikAI)
cd HongikAI

# Download the large font files tracked by LFS
git lfs install
git lfs pull

3. Install Dependencies
Bash
pip install -r requirements.txt

4. System Prerequisites (Linux Only)
For the GUI to function correctly on Linux, system-level dependencies for Kivy are required.
(Debian/Ubuntu command is provided in your original text)

5. Run the Application
Bash
cd katrain/katrain
python __main__.py

Contact
Developer: BNY
Contributor: Minji Seo, Hyeonji Seong

Email: [email protected]