Actualizar README.md con una introducción detallada del agente y enlaces útiles. Integrar el contenido del README en la interfaz de usuario y ajustar el título de la interfaz combinada.

README.md

@@ -11,5 +11,64 @@ tags:
   - mcp-server-track
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
-Hello!
+# 🧙‍♂️ LLM Game Master Agent 🐉
+
+## Useful Links:
+- [Owlbear Rodeo Chat Interface](https://github.com/Agamador/OwlBear-llm-chat)
+- [MCP server](https://huggingface.co/spaces/Agents-MCP-Hackathon/LLM-GameMaster-MPC-Server)
+- [Video Demo](https://www.youtube.com/watch?v=8b1k2g3Z4aY)
+
+## 🌟 Introduction
+
+The **LLM Game Master Agent** is a sophisticated AI system designed as a Game Master (GM) for solo medieval fantasy role-playing sessions. This cutting-edge application showcases the power of LangGraph React architecture combined with Model Context Protocol (MCP) technology, creating an immersive and highly adaptive gaming experience unlike anything seen before.
+
+Unlike conventional chatbots, this intelligent agent generates dynamic and personalized narratives where YOU become the protagonist in epic fantasy stories. The application leverages state-of-the-art language models to deliver a gaming experience comparable to traditional sessions with a human Game Master, but with the added benefits of AI-powered adaptability and endless creative possibilities.
+
+## 🧠 LangGraph React: The System Core
+
+The LLM Game Master Agent utilizes [LangGraph](https://github.com/langchain-ai/langgraph) as the central component of its architecture, implementing the React pattern for complex task management. 
+
+The implementation uses LangGraph's `create_react_agent` function to create a reactive agent that can maintain conversation state, reason over multiple steps, and make informed decisions based on the complete tools execution trace.
+
+![./media/reactAgent.png](./media/reactagent.png)
+
+## 🔌 MCP Client: Integration with External Tools
+
+The system implements a [Model Context Protocol (MCP)](https://github.com/microsoft/model-context-protocol) client that connects to an external MCP server. This client-server architecture allows the agent to access specialized gaming tools without implementing them directly in the codebase.
+
+The implementation uses MCP-specific adapters for LangChain that facilitate communication between the agent and the tools server.
+
+This architecture separates the agent logic from the tool implementation, making the system more modular and easier to maintain. The agent can invoke tools as needed through the MCP connection, while focusing on its core narrative generation and decision-making capabilities.
+
+## 🤖 Language Model Orchestration
+
+The system uses [LangChain](https://www.langchain.com/) to orchestrate language models, offering compatibility with:
+
+- **Anthropic Claude**: Claude 3 models via API
+- **Ollama**: Local deployment of models for self-hosted scenarios
+
+This flexibility allows selecting the most suitable model based on performance requirements and availability.
+
+## 🖥️ Gradio User Interface
+
+The application features a complete web interface built with Gradio, offering two main views:
+
+1. **Complete View with History**: Shows the conversation along with detailed execution tracking including tools and agent messages.
+2. **Original API**: A simpler interface for API access.
+
+The interface includes features for:
+
+- Tracking multiple sessions via tab IDs
+- Detailed visualization of tool calls and their results
+- Session management controls
+- API key configuration
+
+The execution history provides complete transparency into the agent's decision-making process, showing each step of the interaction between the user, agent, and tools.
+
+
+## 🔗 Links & Resources
+
+- [LangGraph Documentation](https://github.com/langchain-ai/langgraph)
+- [Model Context Protocol (MCP)](https://github.com/microsoft/model-context-protocol)
+- [LangChain](https://www.langchain.com/)
+- [Gradio](https://www.gradio.app/)

app.py

@@ -353,11 +353,21 @@ api_demo = gr.Interface(
     outputs="text",    title="OwlBear Agent - Original API"
 )
 
+with open("README.md", "r") as f:
+    readme = f.read()
+
+intro_demo = gr.Markdown(
+    readme,
+    title="🧙🏼‍♂️ LLM Game Master - Agen",
+    description="This interface introduces the Agent",
+    api_name=False,
+)
+
 # Combined interface with tabs
 combined_demo = gr.TabbedInterface(
-    [demo, api_demo],
+    [intro_demo, demo, api_demo],
     ["Complete View with History", "Original API"],
-    title="🦉 OwlBear Agent - Complete Interface"
+    title="🧙🏼‍♂️ LLM Game Master - Agent"
 )
 
 if __name__ == "__main__":