README.md

metadata

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

🧬 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.

This project is a submission for the Agentic Demo Showcase track in the Agents & MCP Hackathon.

---

🎥 Witness the Creation: Demo Video

(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"가 되면, 오른쪽 하단에 새로운 상호작용형 애플리케이션(스네이크 게임)이 나타납니다. 바로 플레이해보세요!