zizthefox commited on
Commit
6bec5b9
·
1 Parent(s): 79216f0

feat: create uv env

Browse files
Files changed (6) hide show
  1. .python-version +1 -0
  2. PROGRESS.md +95 -0
  3. app.py +7 -0
  4. main.py +6 -0
  5. pyproject.toml +9 -0
  6. uv.lock +0 -0
.python-version ADDED
@@ -0,0 +1 @@
 
 
1
+ 3.12
PROGRESS.md ADDED
@@ -0,0 +1,95 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Echo Hearts - Development Progress
2
+
3
+ ## Project Overview
4
+ AI Companion RPG with emergent relationships built on Model Context Protocol (MCP)
5
+
6
+ **Hackathon**: MCP's 1st Birthday Hackathon (Nov 2025)
7
+ **Track**: MCP in Action - Games Category
8
+ **Repository**: echo-hearts
9
+
10
+ ---
11
+
12
+ ## Available APIs & Credits
13
+
14
+ ### Primary AI APIs
15
+ - **Anthropic Claude** - $25k total credits available
16
+ - Best for: Character dialogue, personality modeling, context understanding
17
+ - Recommended for main companion AI
18
+
19
+ - **OpenAI** - $25 credits per participant
20
+ - Option for: Alternative dialogue generation
21
+
22
+ - **Google Gemini** - $30k total credits ($10k per category)
23
+ - Option for: Multimodal interactions
24
+
25
+ - **SambaNova** - $25 credits (1500 participants)
26
+ - Option for: Fast inference
27
+
28
+ ### Supporting Services
29
+ - **ElevenLabs** - $44 membership credits (5000 participants)
30
+ - Use for: Voice synthesis for companions
31
+
32
+ - **Modal** - $250 credits + $2,500 innovation award potential
33
+ - Use for: Serverless deployment, scaling
34
+
35
+ - **Blaxel** - $250 credits + $2,500 choice award potential
36
+ - TBD usage
37
+
38
+ - **Hugging Face** - $25 credits
39
+ - Use for: Model hosting, deployment
40
+
41
+ ---
42
+
43
+ ## Technical Stack
44
+
45
+ ### Confirmed
46
+ - [x] MCP (Model Context Protocol)
47
+ - [x] Gradio 6
48
+ - [x] Git repository initialized
49
+
50
+ ### To Implement
51
+ - [ ] Choose primary AI API (Recommended: Anthropic Claude)
52
+ - [ ] MCP server setup for character memory
53
+ - [ ] Character personality agents
54
+ - [ ] Conversation memory system
55
+ - [ ] Gradio interface
56
+ - [ ] Session persistence
57
+
58
+ ---
59
+
60
+ ## Development Roadmap
61
+
62
+ ### Phase 1: Foundation
63
+ - [ ] Set up MCP server
64
+ - [ ] Configure API credentials (Claude recommended)
65
+ - [ ] Design character memory schema
66
+ - [ ] Create basic Gradio interface
67
+
68
+ ### Phase 2: Core Features
69
+ - [ ] Implement first AI companion agent
70
+ - [ ] Build conversation memory system
71
+ - [ ] Test personality emergence
72
+ - [ ] Add context retrieval
73
+
74
+ ### Phase 3: Enhancement
75
+ - [ ] Multiple companions
76
+ - [ ] Relationship dynamics
77
+ - [ ] Voice integration (ElevenLabs)
78
+ - [ ] Session history
79
+
80
+ ### Phase 4: Polish
81
+ - [ ] Deploy to Modal/Hugging Face
82
+ - [ ] Demo preparation
83
+ - [ ] Documentation
84
+
85
+ ---
86
+
87
+ ## Notes
88
+ - Focus on MCP for persistent memory - this is the key differentiator
89
+ - Use Claude API for natural, context-aware dialogue
90
+ - Keep companions autonomous with individual MCP contexts
91
+ - Gradio 6 for quick interactive prototyping
92
+
93
+ ---
94
+
95
+ **Last Updated**: 2025-11-19
app.py CHANGED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ import gradio as gr
2
+
3
+ def greet(name):
4
+ return "Hello " + name + "!!"
5
+
6
+ demo = gr.Interface(fn=greet, inputs="text", outputs="text")
7
+ demo.launch()
main.py ADDED
@@ -0,0 +1,6 @@
 
 
 
 
 
 
 
1
+ def main():
2
+ print("Hello from echo-hearts!")
3
+
4
+
5
+ if __name__ == "__main__":
6
+ main()
pyproject.toml ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
 
1
+ [project]
2
+ name = "echo-hearts"
3
+ version = "0.1.0"
4
+ description = "Add your description here"
5
+ readme = "README.md"
6
+ requires-python = ">=3.12"
7
+ dependencies = [
8
+ "gradio>=5.49.1",
9
+ ]
uv.lock ADDED
The diff for this file is too large to render. See raw diff