Archive: System v4 - Estado al 2024-12-24

v4-archive/penny/README.md

@@ -0,0 +1,49 @@
+# PENNY - Personal ENgaging Natural Yielder
+
+## Descripción
+Asistente de voz conversacional que orquesta GRACE y Claude API.
+
+## Endpoint RunPod
+- ID: `0mxhaokgsmgee3`
+- URL: `https://api.runpod.ai/v2/0mxhaokgsmgee3/runsync`
+- Workers: 2
+- GPU: NVIDIA L4
+
+## Código
+Ubicación: `s3://architect/gpu-services/penny/code/handler.py`
+
+## Flujo
+```
+Audio → PENNY → GRACE/ASR → Claude API → GRACE/TTS → Audio
+                    ↓
+                CLARA (contexto)
+```
+
+## Uso
+```json
+{
+  "input": {
+    "audio_base64": "...",
+    "session_id": "user_123",
+    "language": "es",
+    "personality": "...",
+    "voice_id": "default"
+  }
+}
+```
+
+## Respuesta
+```json
+{
+  "text_input": "lo que dijo el usuario",
+  "text_output": "respuesta de Claude",
+  "audio_base64": "audio de respuesta",
+  "trace_id": "...",
+  "session_id": "user_123"
+}
+```
+
+## Dependencias
+- GRACE (ASR/TTS)
+- CLARA (contexto)
+- Claude API