ccode / README.md
kimhyunwoo's picture
Update README.md
e82272a verified

A newer version of the Gradio SDK is available: 5.34.1

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

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


πŸŽ₯ Witness the Creation: Demo Video

Genesis Agent 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"κ°€ 되면, 였λ₯Έμͺ½ ν•˜λ‹¨μ— μƒˆλ‘œμš΄ μƒν˜Έμž‘μš©ν˜• μ• ν”Œλ¦¬μΌ€μ΄μ…˜(μŠ€λ„€μ΄ν¬ κ²Œμž„)이 λ‚˜νƒ€λ‚©λ‹ˆλ‹€. λ°”λ‘œ ν”Œλ ˆμ΄ν•΄λ³΄μ„Έμš”!