Update README.md

README.md

@@ -1,6 +1,6 @@
 ---
 title: Forge AI Agent
-emoji: Forge AI Agent 🚀
+emoji: 🚀
 colorFrom: blue
 colorTo: green
 sdk: gradio
@@ -8,31 +8,46 @@ sdk_version: 5.36.2
 python_version: 3.10
 app_file: app.py
 ---
+🧠 Forge: The Autonomous AI Software Engineer
+Forge is an experimental AI agent that simulates autonomous software development. Given a high-level goal, the agent plans and executes tasks using a suite of tools accessible via the Model Context Protocol (MCP).
 
-# Forge - The Autonomous AI Software Engineer
+This demo showcases Forge's architecture and logic, integrated with a mock MCP server and a real-time Gradio interface.
 
-This Hugging Face Space demonstrates the "Forge" concept: an autonomous AI agent that can understand a high-level goal, create a plan, and execute it using a suite of tools exposed via the Model Context Protocol (MCP).
+🔍 How It Works
+Define a Goal
+Enter a high-level software task (e.g., "Build a Flask API for user signup").
 
-## How It Works
+Planning Phase
+A mock AI agent analyzes the goal and lists available tools, then generates a step-by-step execution plan.
 
-1.  **User Goal**: You provide a high-level software development task in the textbox.
-2.  **Planning**: An AI agent (mocked in this demo) receives the goal and a list of available tools. It generates a step-by-step plan to achieve the goal.
-3.  **Execution**: The Forge orchestrator executes each step in the plan by calling the appropriate tool from a mock MCP server.
-4.  **Live Feedback**: The agent's thoughts, actions, and results are streamed to the UI in real-time.
+Execution Phase
+The Forge orchestrator runs each step in the plan by invoking appropriate tools via a mock MCP server.
 
-## Running Locally
+Live Agent Feedback
+The UI streams the agent’s decisions, actions, and intermediate results in real-time.
 
-This application is designed to be self-contained, but for local development, you need to run the mock MCP servers that the agent communicates with.
+🧪 Local Development
+To run Forge locally, you'll need to set up both the mock MCP servers and the Gradio interface.
+
+1. Install Dependencies
+bash
+Copy
+Edit
+pip install -r requirements.txt
+2. Start Mock MCP Servers (in a separate terminal)
+bash
+Copy
+Edit
+python mock_mcp_servers/run_servers.py
+3. Launch the Gradio App
+bash
+Copy
+Edit
+python app.py
+🚧 Notes
+The current agent logic is mocked for demonstration.
+
+The system is modular and can be extended to use real tools, LLMs, and dynamic backends.
+
+This project uses Gradio 5.36.2 and Python 3.10.
 
-1.  **Install dependencies:**
-    ```bash
-    pip install -r requirements.txt
-    ```
-2.  **Run the mock servers in a separate terminal:**
-    ```bash
-    python mock_mcp_servers/run_servers.py
-    ```
-3.  **Run the Gradio app:**
-    ```bash
-    gradio app.py
-    ```