README.md

metadata

title: Forge AI Agent
emoji: Forge AI Agent 🚀
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.28.3
python_version: 3.1
app_file: app.py

Forge - The Autonomous AI Software Engineer

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

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.

Running Locally

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.

1. Install dependencies:

   pip install -r requirements.txt
   

2. Run the mock servers in a separate terminal:

   python mock_mcp_servers/run_servers.py
   

3. Run the Gradio app:

   gradio app.py