Spaces:
Sleeping
Sleeping
feat: create uv env
Browse files- .python-version +1 -0
- PROGRESS.md +95 -0
- app.py +7 -0
- main.py +6 -0
- pyproject.toml +9 -0
- 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
|
|
|