Madras1 commited on
Commit
b7c2ffb
·
verified ·
1 Parent(s): 19e26d7

Upload 4 files

Browse files
Files changed (1) hide show
  1. README.md +17 -44
README.md CHANGED
@@ -1,49 +1,23 @@
1
- # 3D Avatar Chat - Backend
 
 
 
 
 
 
 
 
 
 
2
 
3
  Backend para o sistema de chat com avatar 3D falante.
4
 
5
  ## Tech Stack
6
  - **FastAPI** - API REST
7
  - **OpenRouter** - LLM para respostas
8
- - **Edge TTS** - Síntese de voz
9
 
10
- ## Executar Localmente
11
-
12
- ```bash
13
- # Instalar dependências
14
- pip install -r requirements.txt
15
-
16
- # Configurar variável de ambiente
17
- export OPENROUTER_API_KEY="sua-chave-aqui"
18
-
19
- # Rodar servidor
20
- python app.py
21
- # ou
22
- uvicorn app:app --reload --port 7860
23
- ```
24
-
25
- ## Deploy no HuggingFace Spaces
26
-
27
- 1. Criar novo Space (SDK: Docker ou Gradio)
28
- 2. Adicionar secret `OPENROUTER_API_KEY` nas configurações
29
- 3. Push do código
30
-
31
- ### Dockerfile (se usar Docker SDK)
32
-
33
- ```dockerfile
34
- FROM python:3.11-slim
35
-
36
- WORKDIR /app
37
- COPY requirements.txt .
38
- RUN pip install --no-cache-dir -r requirements.txt
39
-
40
- COPY app.py .
41
-
42
- EXPOSE 7860
43
- CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]
44
- ```
45
-
46
- ## Endpoints
47
 
48
  ### GET /
49
  Health check básico.
@@ -68,9 +42,7 @@ Processa mensagem e retorna resposta com áudio.
68
  "text": "Olá! Estou muito bem, obrigada por perguntar!",
69
  "audio_base64": "//uQxAAAAAANIAAAAAExBTUUzLjEwMFVV...",
70
  "visemes": [
71
- {"time": 0.0, "viseme": "O", "duration": 0.065},
72
- {"time": 0.065, "viseme": "L", "duration": 0.065},
73
- ...
74
  ],
75
  "duration": 3.2
76
  }
@@ -78,6 +50,7 @@ Processa mensagem e retorna resposta com áudio.
78
 
79
  ## Configuração
80
 
81
- Variáveis de ambiente:
82
- - `OPENROUTER_API_KEY` - Chave da API OpenRouter (obrigatório)
 
83
  - `OPENROUTER_MODEL` - Modelo a usar (default: `google/gemini-2.0-flash-001`)
 
1
+ ---
2
+ title: OpenAda
3
+ emoji: 🤖
4
+ colorFrom: indigo
5
+ colorTo: purple
6
+ sdk: docker
7
+ app_file: app.py
8
+ pinned: false
9
+ ---
10
+
11
+ # OpenAda - 3D Avatar Chat Backend
12
 
13
  Backend para o sistema de chat com avatar 3D falante.
14
 
15
  ## Tech Stack
16
  - **FastAPI** - API REST
17
  - **OpenRouter** - LLM para respostas
18
+ - **Edge TTS** - Síntese de voz (pt-BR-FranciscaNeural)
19
 
20
+ ## API Endpoints
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
21
 
22
  ### GET /
23
  Health check básico.
 
42
  "text": "Olá! Estou muito bem, obrigada por perguntar!",
43
  "audio_base64": "//uQxAAAAAANIAAAAAExBTUUzLjEwMFVV...",
44
  "visemes": [
45
+ {"time": 0.0, "viseme": "O", "duration": 0.065}
 
 
46
  ],
47
  "duration": 3.2
48
  }
 
50
 
51
  ## Configuração
52
 
53
+ Configure o secret `OPENROUTER_API_KEY` nas configurações do Space.
54
+
55
+ Variáveis de ambiente opcionais:
56
  - `OPENROUTER_MODEL` - Modelo a usar (default: `google/gemini-2.0-flash-001`)