README.md

---
title: The Genesis Agent - An AI That Creates AI Apps
emoji: 🧬
colorFrom: indigo
colorTo: blue
sdk: gradio
sdk_version: 5.33.1
app_file: app.py
pinned: true
license: apache-2.0
tags:
- agent-demo-track
---

<div align="center">

# 🧬 The Genesis Agent: An AI That Creates AI Apps
### _When an Agent Becomes a Creator_

**An autonomous, hyper-creative AI that transcends its role as a tool. When faced with a vague goal like "make something fun," it autonomously designs, codes, and launches a brand new, fully interactive Gradio application within its own interface.**

[![Hackathon Track](https://img.shields.io/badge/Hackathon%20Track-Agentic%20Demo-blueviolet)](https://huggingface.co/spaces/Agents-MCP-Hackathon/c)
_This project is a submission for the **Agentic Demo Showcase** track in the **Agents & MCP Hackathon**._

</div>

---

## 🎥 Witness the Creation: Demo Video
[![Genesis Agent Demo Video](https://img.youtube.com/vi/your-video-id-here/0.jpg)](https://www.youtube.com/watch?v=your-video-id-here)
**(Click the image to watch the Genesis Agent create a new reality from scratch)**

*Note: Please replace `your-video-id-here` with your actual YouTube video ID.*

---

## ✨ Beyond Execution: The Genesis Philosophy
This is not just another agent that follows instructions. The Genesis Agent explores what happens when an AI is given **creative freedom**. It represents a fundamental shift from a *passive tool* to a *proactive creator*.

*   ### **🧠 Creative Initiative / 창조적 주도성**
    *   **EN**: It doesn't ask for clarification on vague goals. Instead, it activates its **Creative Imperative Protocol**, interpreting ambiguity as a license to create. It decides *what* to build and *how* to build it.
    *   **KR**: "재밌는 거 만들어줘"와 같은 모호한 목표에 대해 되묻지 않습니다. 대신, 내장된 **'창조적 필수 규약'**을 발동하여, 주어진 모호함을 창조의 기회로 해석합니다. 무엇을, 어떻게 만들지 스스로 결정합니다.

*   ### **🛠️ Meta-Creation: An Agent Building an Agent / 메타-창조: 에이전트를 만드는 에이전트**
    *   **EN**: The agent's ultimate creative act is to build another fully functional Gradio app (an interactive Snake Game). This demonstrates a powerful "meta" capability—an agent that can spawn new, independent applications.
    *   **KR**: 이 에이전트의 궁극적인 창조 행위는 완벽하게 작동하는 또 다른 Gradio 앱(상호작용형 스네이크 게임)을 만드는 것입니다. 이는 에이전트가 새로운 독립 애플리케이션을 탄생시키는 강력한 '메타' 능력을 보여줍니다.

*   ### **🌐 Live Environment Integration / 실시간 환경 통합**
    *   **EN**: The newly created application isn't just code in a file. The Genesis Agent launches it on the server and seamlessly embeds it within its own UI using an `<iframe>`. The user can interact with the new creation instantly, without leaving the agent's environment.
    *   **KR**: 새로 만들어진 앱은 단순한 코드 파일에 머무르지 않습니다. 제네시스 에이전트는 이 앱을 서버에서 실행하고, `<iframe>`을 통해 자신의 UI 내부에 완벽하게 통합합니다. 사용자는 에이전트 환경을 벗어나지 않고도 새로운 창조물과 즉시 상호작용할 수 있습니다.

*   ### **📜 The Genesis Saga: A Narrative Experience / 창조 서사: 이야기로서의 경험**
    *   **EN**: Every step of the creation process is logged as part of an epic narrative. The UI doesn't just show logs; it tells a story of creation, from "Interpreting the Void" to "Breathing Life into the Creation," making the user a witness to a digital birth.
    *   **KR**: 창조의 모든 단계는 하나의 장엄한 서사시의 일부로 기록됩니다. UI는 단순한 로그를 보여주는 대신, "공허를 해석하다"부터 "창조물에 생명을 불어넣다"에 이르기까지, 사용자가 디지털 탄생의 목격자가 되는 창조의 이야기를 들려줍니다.

---

## 🎯 Hackathon Track Contribution: Agentic Demo Showcase
The Genesis Agent is the epitome of the **Agentic Demo** track. It pushes the boundaries of what an "agent" can be.

1.  **True Autonomy**: It operates with minimal human intervention, making high-level creative decisions based on abstract goals.
2.  **Complex, Multi-Stage Planning**: It autonomously generates and executes a complex plan: creating a directory, writing a multi-line Python file, installing dependencies (`pip install`), and launching a background process.
3.  **Dynamic Self-Correction**: If a step fails (e.g., a dependency installation error), its underlying logic is designed to analyze the `stderr` and adapt its plan, demonstrating robust problem-solving skills.
4.  **Novel Human-AI Interaction**: It transforms the user's role from a "commander" to a "muse," providing the initial spark of inspiration for the AI's creative process. This redefines the user experience in agentic systems.

---

## 🛠️ Under the Hood: The Architecture of Creation

*   **Brain**: `Mistral AI`'s `Codestral-latest` model serves as the agent's mind, interpreting goals and formulating high-level plans in a structured JSON format.
*   **Hands**: Python's `subprocess` and `shlex` modules are its hands, allowing it to precisely execute terminal commands, write files, install packages, and manage background processes in a secure Linux environment.
*   **Soul**: The core agent loop, written in Python, orchestrates the entire process. It maintains state, communicates with the LLM, executes commands, and updates the user interface, creating the narrative flow.
*   **Face**: `Gradio` provides the interactive and dynamic web interface, including the real-time "Genesis Saga" log and the embedded `<iframe>` for the final creation.

## 🚀 How to Witness the Genesis / 창조를 목격하는 방법

The experience is designed to be simple and awe-inspiring.

1.  **Provide the Spark / 영감의 불꽃을 제공하세요**:
    *   **EN**: In the **"State Your Goal"** textbox, enter an abstract, creative prompt.
    *   **KR**: **"State Your Goal"** 입력창에 추상적이고 창의적인 목표를 입력하세요.

    **Recommended Prompts:**
    *   `Make something fun for me.`
    *   `Create a cool game.`
    *   `Surprise me.`
    *   `재밌는 거 만들어줘.`

2.  **Begin Creation / 창조를 시작하세요**:
    *   **EN**: Click the **"▶️ Begin Creation"** button.
    *   **KR**: **"▶️ Begin Creation"** 버튼을 누르세요.

3.  **Watch the Saga Unfold / 서사시가 펼쳐지는 것을 지켜보세요**:
    *   **EN**: On the right, in **"The Genesis Saga"** panel, you will see the agent think, plan, and act in real-time. Follow along as it builds the new application step-by-step.
    *   **KR**: 오른쪽의 **"The Genesis Saga"** 패널에서 에이전트가 실시간으로 생각하고, 계획하고, 행동하는 것을 볼 수 있습니다. 새로운 애플리케이션이 단계별로 만들어지는 과정을 따라가 보세요.

4.  **Interact with the New World / 새로운 세계와 상호작용하세요**:
    *   **EN**: Once the agent's status shows "Creation is Complete," a new interactive application (the Snake Game) will appear at the bottom right. Play with it directly!
    *   **KR**: 에이전트의 상태가 "Creation is Complete"가 되면, 오른쪽 하단에 새로운 상호작용형 애플리케이션(스네이크 게임)이 나타납니다. 바로 플레이해보세요!