diff --git a/ai_agent_tutorials/ai_chess_agent/README.md b/ai_agent_tutorials/ai_chess_agent/README.md new file mode 100644 index 0000000..731db80 --- /dev/null +++ b/ai_agent_tutorials/ai_chess_agent/README.md @@ -0,0 +1,46 @@ +# ♜ Agent White vs Agent Black: Chess Game + +An advanced Chess game system where two AI agents play chess against each other using Autogen in a streamlit app. It is built with robust move validation and game state management. + +## Features + +### Multi-Agent Architecture +- Player White: OpenAI-powered strategic decision maker +- Player Black: OpenAI-powered tactical opponent +- Board Proxy: Validation agent for move legality and game state + +### Safety & Validation +- Robust move verification system +- Illegal move prevention +- Real-time board state monitoring +- Secure game progression control + +### Strategic Gameplay +- AI-powered position evaluation +- Deep tactical analysis +- Dynamic strategy adaptation +- Complete chess ruleset implementation + + +### How to get Started? + +1. Clone the GitHub repository + +```bash +git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git +cd ai_agent_tutorials/ai_chess_game +``` +2. Install the required dependencies: + +```bash +pip install -r requirements.txt +``` +3. Get your OpenAI API Key + +- Sign up for an [OpenAI account](https://platform.openai.com/) (or the LLM provider of your choice) and obtain your API key. + +4. Run the Streamlit App +```bash +streamlit run ai_chess_agent.py +``` + diff --git a/ai_agent_tutorials/ai_chess_game/ai_chess_agents.py b/ai_agent_tutorials/ai_chess_agent/ai_chess_agent.py similarity index 100% rename from ai_agent_tutorials/ai_chess_game/ai_chess_agents.py rename to ai_agent_tutorials/ai_chess_agent/ai_chess_agent.py diff --git a/ai_agent_tutorials/ai_chess_game/requirements.txt b/ai_agent_tutorials/ai_chess_agent/requirements.txt similarity index 100% rename from ai_agent_tutorials/ai_chess_game/requirements.txt rename to ai_agent_tutorials/ai_chess_agent/requirements.txt diff --git a/ai_agent_tutorials/ai_chess_game/README.md b/ai_agent_tutorials/ai_chess_game/README.md deleted file mode 100644 index ae559f0..0000000 --- a/ai_agent_tutorials/ai_chess_game/README.md +++ /dev/null @@ -1,31 +0,0 @@ -# AI Chess Game - Autogen - -This is a simple Chess game that uses an AI agents - Player black and player white to play the game. There's also a board proxy agent to execute the tools and manage the game. It is important to use a board proxy as a non-LLM "guard rail" to ensure the game is played correctly and to prevent agents from making illegal moves. - -Two agents (agent_white and agent_black) are initialized using the OpenAI API key. These agents are configured to play chess as white and black, respectively. -A board_proxy agent is created to manage the board state and validate moves. -Functions (make_move and available_moves) are registered with the agents to allow them to interact with the board. - - -### How to get Started? - -1. Clone the GitHub repository - -```bash -git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git -cd ai_agent_tutorials/ai_chess_game -``` -2. Install the required dependencies: - -```bash -pip install -r requirements.txt -``` -3. Get your OpenAI API Key - -- Sign up for an [OpenAI account](https://platform.openai.com/) (or the LLM provider of your choice) and obtain your API key. - -4. Run the Streamlit App -```bash -streamlit run ai_chess_agents.py -``` -