Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
@@ -1,99 +1,99 @@
|
|
1 |
---
|
2 |
-
title: The
|
3 |
-
emoji:
|
4 |
-
colorFrom:
|
5 |
-
colorTo:
|
6 |
sdk: gradio
|
7 |
-
sdk_version:
|
8 |
app_file: app.py
|
9 |
pinned: true
|
10 |
-
license:
|
11 |
tags:
|
12 |
- agent-demo-track
|
13 |
-
- mcp-server-track
|
14 |
---
|
15 |
|
16 |
<div align="center">
|
17 |
|
18 |
-
#
|
|
|
19 |
|
20 |
-
**An
|
21 |
|
22 |
-
[ throughout the conversation, building upon previous steps.
|
71 |
-
2. **Complex Command Parsing**: It deconstructs user requests based on connectors like "and" or "then" to create a multi-step execution plan.
|
72 |
-
3. **Autonomous Tool Use**: Based on its plan, the agent autonomously selects and uses its internal tools: `generate_code`, `compile_and_run`, and `analyze_and_refactor`.
|
73 |
|
74 |
-
|
75 |
|
76 |
-
|
|
|
|
|
|
|
77 |
|
78 |
-
|
79 |
-
* Each function in this tab (`Generate C Code`, `Compile & Run C Code`, etc.) acts as a discrete API endpoint that can be called by any MCP client or other agents.
|
80 |
-
* This exposes the agent's powerful C language processing capabilities as modular tools, allowing other AI services to easily integrate them.
|
81 |
|
82 |
-
|
83 |
|
84 |
-
|
|
|
|
|
85 |
|
86 |
-
|
87 |
-
*
|
88 |
-
*
|
89 |
-
*
|
|
|
90 |
|
91 |
-
|
|
|
|
|
92 |
|
93 |
-
|
94 |
-
* **EN**:
|
95 |
-
* **KR**:
|
96 |
|
97 |
-
|
98 |
-
* **EN**:
|
99 |
-
* **KR**:
|
|
|
1 |
---
|
2 |
+
title: The Genesis Agent - An AI That Creates AI Apps
|
3 |
+
emoji: π§¬
|
4 |
+
colorFrom: indigo
|
5 |
+
colorTo: blue
|
6 |
sdk: gradio
|
7 |
+
sdk_version: 4.31.0
|
8 |
app_file: app.py
|
9 |
pinned: true
|
10 |
+
license: apache-2.0
|
11 |
tags:
|
12 |
- agent-demo-track
|
|
|
13 |
---
|
14 |
|
15 |
<div align="center">
|
16 |
|
17 |
+
# 𧬠The Genesis Agent: An AI That Creates AI Apps
|
18 |
+
### _When an Agent Becomes a Creator_
|
19 |
|
20 |
+
**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.**
|
21 |
|
22 |
+
[](https://huggingface.co/spaces/Agents-MCP-Hackathon/c)
|
23 |
+
_This project is a submission for the **Agentic Demo Showcase** track in the **Agents & MCP Hackathon**._
|
24 |
|
25 |
</div>
|
26 |
|
|
|
|
|
27 |
---
|
28 |
|
29 |
+
## π₯ Witness the Creation: Demo Video
|
30 |
+
[](https://www.youtube.com/watch?v=your-video-id-here)
|
31 |
+
**(Click the image to watch the Genesis Agent create a new reality from scratch)**
|
|
|
|
|
32 |
|
33 |
+
*Note: Please replace `your-video-id-here` with your actual YouTube video ID.*
|
34 |
|
35 |
+
---
|
36 |
|
37 |
+
## β¨ Beyond Execution: The Genesis Philosophy
|
38 |
+
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*.
|
|
|
39 |
|
40 |
+
* ### **π§ Creative Initiative / μ°½μ‘°μ μ£Όλμ±**
|
41 |
+
* **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.
|
42 |
+
* **KR**: "μ¬λ°λ κ±° λ§λ€μ΄μ€"μ κ°μ λͺ¨νΈν λͺ©νμ λν΄ λλ¬»μ§ μμ΅λλ€. λμ , λ΄μ₯λ **'μ°½μ‘°μ νμ κ·μ½'**μ λ°λνμ¬, μ£Όμ΄μ§ λͺ¨νΈν¨μ μ°½μ‘°μ κΈ°νλ‘ ν΄μν©λλ€. 무μμ, μ΄λ»κ² λ§λ€μ§ μ€μ€λ‘ κ²°μ ν©λλ€.
|
43 |
|
44 |
+
* ### **π οΈ Meta-Creation: An Agent Building an Agent / λ©ν-μ°½μ‘°: μμ΄μ νΈλ₯Ό λ§λλ μμ΄μ νΈ**
|
45 |
+
* **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.
|
46 |
+
* **KR**: μ΄ μμ΄μ νΈμ κΆκ·Ήμ μΈ μ°½μ‘° νμλ μλ²½νκ² μλνλ λ λ€λ₯Έ Gradio μ±(μνΈμμ©ν μ€λ€μ΄ν¬ κ²μ)μ λ§λλ κ²μ
λλ€. μ΄λ μμ΄μ νΈκ° μλ‘μ΄ λ
립 μ ν리μΌμ΄μ
μ νμμν€λ κ°λ ₯ν 'λ©ν' λ₯λ ₯μ 보μ¬μ€λλ€.
|
47 |
|
48 |
+
* ### **π Live Environment Integration / μ€μκ° νκ²½ ν΅ν©**
|
49 |
+
* **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.
|
50 |
+
* **KR**: μλ‘ λ§λ€μ΄μ§ μ±μ λ¨μν μ½λ νμΌμ 머무λ₯΄μ§ μμ΅λλ€. μ λ€μμ€ μμ΄μ νΈλ μ΄ μ±μ μλ²μμ μ€ννκ³ , `<iframe>`μ ν΅ν΄ μμ μ UI λ΄λΆμ μλ²½νκ² ν΅ν©ν©λλ€. μ¬μ©μλ μμ΄μ νΈ νκ²½μ λ²μ΄λμ§ μκ³ λ μλ‘μ΄ μ°½μ‘°λ¬Όκ³Ό μ¦μ μνΈμμ©ν μ μμ΅λλ€.
|
51 |
|
52 |
+
* ### **π The Genesis Saga: A Narrative Experience / μ°½μ‘° μμ¬: μ΄μΌκΈ°λ‘μμ κ²½ν**
|
53 |
+
* **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.
|
54 |
+
* **KR**: μ°½μ‘°μ λͺ¨λ λ¨κ³λ νλμ μ₯μν μμ¬μμ μΌλΆλ‘ κΈ°λ‘λ©λλ€. UIλ λ¨μν λ‘κ·Έλ₯Ό 보μ¬μ£Όλ λμ , "곡νλ₯Ό ν΄μνλ€"λΆν° "μ°½μ‘°λ¬Όμ μλͺ
μ λΆμ΄λ£λ€"μ μ΄λ₯΄κΈ°κΉμ§, μ¬μ©μκ° λμ§νΈ νμμ λͺ©κ²©μκ° λλ μ°½μ‘°μ μ΄μΌκΈ°λ₯Ό λ€λ €μ€λλ€.
|
55 |
|
56 |
---
|
57 |
|
58 |
+
## π― Hackathon Track Contribution: Agentic Demo Showcase
|
59 |
+
The Genesis Agent is the epitome of the **Agentic Demo** track. It pushes the boundaries of what an "agent" can be.
|
60 |
|
61 |
+
1. **True Autonomy**: It operates with minimal human intervention, making high-level creative decisions based on abstract goals.
|
62 |
+
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.
|
63 |
+
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.
|
64 |
+
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.
|
65 |
|
66 |
+
---
|
|
|
|
|
|
|
|
|
|
|
67 |
|
68 |
+
## π οΈ Under the Hood: The Architecture of Creation
|
69 |
|
70 |
+
* **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.
|
71 |
+
* **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.
|
72 |
+
* **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.
|
73 |
+
* **Face**: `Gradio` provides the interactive and dynamic web interface, including the real-time "Genesis Saga" log and the embedded `<iframe>` for the final creation.
|
74 |
|
75 |
+
## π How to Witness the Genesis / μ°½μ‘°λ₯Ό λͺ©κ²©νλ λ°©λ²
|
|
|
|
|
76 |
|
77 |
+
The experience is designed to be simple and awe-inspiring.
|
78 |
|
79 |
+
1. **Provide the Spark / μκ°μ λΆκ½μ μ 곡νμΈμ**:
|
80 |
+
* **EN**: In the **"State Your Goal"** textbox, enter an abstract, creative prompt.
|
81 |
+
* **KR**: **"State Your Goal"** μ
λ ₯μ°½μ μΆμμ μ΄κ³ μ°½μμ μΈ λͺ©νλ₯Ό μ
λ ₯νμΈμ.
|
82 |
|
83 |
+
**Recommended Prompts:**
|
84 |
+
* `Make something fun for me.`
|
85 |
+
* `Create a cool game.`
|
86 |
+
* `Surprise me.`
|
87 |
+
* `μ¬λ°λ κ±° λ§λ€μ΄μ€.`
|
88 |
|
89 |
+
2. **Begin Creation / μ°½μ‘°λ₯Ό μμνμΈμ**:
|
90 |
+
* **EN**: Click the **"βΆοΈ Begin Creation"** button.
|
91 |
+
* **KR**: **"βΆοΈ Begin Creation"** λ²νΌμ λλ₯΄μΈμ.
|
92 |
|
93 |
+
3. **Watch the Saga Unfold / μμ¬μκ° νΌμ³μ§λ κ²μ μ§μΌλ³΄μΈμ**:
|
94 |
+
* **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.
|
95 |
+
* **KR**: μ€λ₯Έμͺ½μ **"The Genesis Saga"** ν¨λμμ μμ΄μ νΈκ° μ€μκ°μΌλ‘ μκ°νκ³ , κ³ννκ³ , νλνλ κ²μ λ³Ό μ μμ΅λλ€. μλ‘μ΄ μ ν리μΌμ΄μ
μ΄ λ¨κ³λ³λ‘ λ§λ€μ΄μ§λ κ³Όμ μ λ°λΌκ° 보μΈμ.
|
96 |
|
97 |
+
4. **Interact with the New World / μλ‘μ΄ μΈκ³μ μνΈμμ©νμΈμ**:
|
98 |
+
* **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!
|
99 |
+
* **KR**: μμ΄μ νΈμ μνκ° "Creation is Complete"κ° λλ©΄, μ€λ₯Έμͺ½ νλ¨μ μλ‘μ΄ μνΈμμ©ν μ ν리μΌμ΄μ
(μ€λ€μ΄ν¬ κ²μ)μ΄ λνλ©λλ€. λ°λ‘ νλ μ΄ν΄λ³΄μΈμ!
|