Torna all’avatar

LiveAvatar · Login DailyPlatform

LIVEAVATAR DAILY - PACCHETTO LINUX / PHP

CONTENUTO E POSIZIONE
Questo archivio e dedicato al server; non contiene emulatore, tunnel, percorsi Windows o credenziali personali.
root-web/ contiene TUTTI i file da caricare nella root web del dominio, mantenendo vendor/.
daily-avatar-private/ va accanto alla root web, NON al suo interno.
Esempio hosting:
 /home/utente/public_html/index.html
 /home/utente/public_html/api.php
 /home/utente/public_html/company-context.php
 /home/utente/public_html/workspace.js
 /home/utente/public_html/vendor/...
 /home/utente/daily-avatar-private/config.json
Il punto iniziale di .htaccess e normale: abilitare la visualizzazione dei file nascosti nel client FTP.
Non caricare l'intero archivio nella root: caricare soltanto il contenuto di root-web/.

1. REQUISITI
PHP 8.1+ (preferibile 8.3 o successiva compatibile), curl, mbstring, JSON e sessioni PHP.
Apache 2.4 con PHP oppure Nginx con PHP-FPM. Nessun database aggiuntivo e nessuna build.
HTTPS valido, certificati CA aggiornati, session.save_path scrivibile e privato.
Consentire richieste HTTPS in uscita a ai.dailyplatform.it, dev.dailyplatform.it e api.liveavatar.com.
Il browser deve poter collegarsi anche a LiveAvatar/LiveKit via WebRTC e al servizio di dettatura del browser.
I servizi Daily AI/CRM e l'abbonamento LiveAvatar devono rimanere operativi: questo pacchetto non installa il loro backend.

2. CONFIGURAZIONE
Aprire daily-avatar-private/config.json e sostituire INSERISCI_SUL_SERVER con la propria chiave LiveAvatar.
Avatar e voce sono gia impostati su Salvatore. Gli endpoint sono quelli attuali: AI ai.dailyplatform.it e CRM dev.dailyplatform.it.
Non passare al CRM di produzione senza verificare che autenticazione, utenti e contratti API coincidano.
Non serve la chiave Gemini nel browser: le risposte provengono dalla vostra AI Daily.
Su Linux usare il trust store CA del sistema: non copiare caBundle con percorsi Windows.
Il file deve essere leggibile da PHP ma non pubblicamente: ad esempio directory 750 e file 640, con gruppo PHP corretto.
Non usare chmod 777.

3. PERCORSO PRIVATO ALTERNATIVO
Se non puoi usare la cartella sorella daily-avatar-private/, imposta DAILY_AVATAR_CONFIG_PATH sul server al percorso assoluto di config.json.
PHP-FPM: env[DAILY_AVATAR_CONFIG_PATH] = /etc/daily-avatar/config.json nel pool, poi ricaricare PHP-FPM.
Alternativa hosting: modificare solo il percorso di fallback nella riga $configFile di api.php, puntando a un file fuori dalla root.
LIVEAVATAR_API_KEY come variabile server puo sostituire la chiave nel JSON.
Non collocare chiavi nell'HTML. .htaccess non protegge Nginx e non sostituisce la collocazione privata.

4. WEB SERVER
Se l'hosting gestisce gia PHP e HTTPS, non serve installare un nuovo web server.
Apache: il .htaccess incluso disabilita gli indici; se il provider non permette Options, disabilitare gli indici dal pannello e rimuovere soltanto Options -Indexes.
Nginx: adatta l'esempio nginx-avatar.conf al dominio, al percorso e al socket PHP installati. Non sovrascrivere un virtual host esistente alla cieca.
Configurare timeout PHP/web server di almeno 120 secondi per le risposte AI (esempi in server-examples/).

5. COLLAUDO
Aprire https://TUO-DOMINIO/ e verificare la login.
Aprire https://TUO-DOMINIO/api.php?action=config: deve restituire authMode=credentials, senza chiavi.
Prima della login api.php?action=companies deve rispondere HTTP 401.
Accedere con le credenziali Daily, controllare il profilo e scegliere una azienda autorizzata.
Fare una domanda sul nome dell'azienda attiva, verificare risposta, video trasparente e voce.
Verificare microfono dopo autorizzazione browser, storico chat per azienda, Esci e nuovo accesso.
Verificare che /config.json, /.env e /daily-avatar-private/config.json non espongano segreti.
Se il video non parte, verificare crediti, autorizzazioni dominio LiveAvatar, HTTPS e connettivita WebRTC.

6. DOMINIO avatar.dy22.it
Oggi il dominio usa il tunnel verso il PC. Copiare i file su Linux NON trasferisce automaticamente il dominio.
Prima collaudare su un hostname temporaneo del server. Poi spostare SOLO la route/DNS di avatar.dy22.it dal tunnel al server Linux.
Con Cloudflare usare un certificato valido sull'origine e modalita TLS Full (strict).
PHP deve riconoscere HTTPS: preferire HTTPS anche tra Cloudflare e server, come negli esempi.
Non fidarsi di X-Forwarded-Proto proveniente da qualunque client. Per un load balancer interno, configurare i proxy fidati nel web server.
Dopo il trasferimento verificare il sito con emulatore e tunnel del PC spenti. Soltanto allora il servizio e verificato come indipendente dal PC.
Questo pacchetto non modifica DNS, CRM o Daily AI.

FUNZIONALITA E LIMITI
Login credenziali CRM, profilo, aziende amministratore, chat personali per azienda, rich text, microfono, voce LiveAvatar e scontorno browser.
Scontorno tarato sull'avatar attuale, non alpha nativo. La singola sessione video e limitata dal piano LiveAvatar, non da un timer di 5 minuti della demo.
Riconnessione prevista alla scadenza riconosciuta; crediti LiveAvatar consumati anche in attesa. Chat mantenuta durante riconnessione video.
Le credenziali Daily non sono incluse e la password non viene salvata dall'app. I token sono nella sessione PHP server.
Dipendenze JavaScript necessarie alla riproduzione incluse in vendor/, licenze incluse. Internet resta necessario per i servizi remoti.

OTTIMIZZAZIONE E CAMBIO AVATAR - 21/10/2026
Buffer e ImageData dello scontorno riutilizzati; canvas ridimensionati solo al cambio risoluzione. Nessuna elaborazione di fotogrammi video duplicati o quando la scheda e nascosta. Eventi delle connessioni video precedenti ignorati dopo sostituzione della stanza. Timeout anche nelle richieste workspace; indisponibilita sessionStorage non impedisce il funzionamento.
Configurazione server: avatarId e voiceId controllano il servizio; displayName imposta l'etichetta sotto l'avatar. backgroundRemoval puo essere auto, calibrated o none.
auto: scontorno attuale solo per l'ID Salvatore conosciuto, video originale per altri ID. calibrated: forza il filtro tarato attuale. none: mostra il video originale, incluso l'eventuale sfondo.
Il cambio avatar non modifica autenticazione, aziende e chat. La compatibilita del modello/voce va verificata sull'account LiveAvatar. Cambiare sfondo o posa anche mantenendo lo stesso ID puo richiedere backgroundRemoval=none oppure una nuova taratura. Non e garantita trasparenza universale; non e possibile ricostruire una figura intera se il video del servizio la taglia. Ricollegare la sessione e ricaricare la pagina dopo cambi di configurazione. Nessuna chiave nel browser.


SALVATORE - ANTEPRIMA UI/UX - 22 OTTOBRE 2026

AMBITO
Il laboratorio avatar.dy22.it ospita la nuova interfaccia candidata per Salvatore.
Non sono stati modificati CRM, Daily AI, database, prompt reali, ruoli o domini Daily.
La configurazione server e api.php restano invariati rispetto alla versione precedente.
Il contenitore CRM e simulato nella stessa pagina: non usa iframe e non e installato nel gestionale.

STRATI DEL CODICE
public/index.html: composizione dell'interfaccia, accesso, contenitore autonomo e CRM simulato.
public/ui/design.css: linguaggio visivo, layout desktop/mobile, accessibilita e stati.
public/ui/components.js: icone, escaping, dialoghi, messaggi e primitive di presentazione.
public/ui/preview-data.js: soli esempi inventati, nessun collegamento di scrittura ai servizi.
public/ui/shell.js: navigazione, filtri, bozze locali, scelta del contenitore e anteprime.
public/workspace.js: adattatore applicativo esistente per accesso, profilo, aziende e chat reali.
public/avatar-session.js: sessione LiveAvatar, audio, microfono, scontorno e pronuncia.
public/api.php e company-context.php: ponte PHP esistente; nessuna modifica nella realizzazione della nuova UI.

FUNZIONI REALI CONSERVATE
Login con credenziali Daily, ripristino della sessione, profilo e logout.
Aziende autorizzate, chat personali per azienda, lettura delle conversazioni e invio alla AI esistente.
LiveAvatar, microfono del browser, editor rich text e pronuncia delle risposte.
Le domande scritte possono essere inviate anche senza video pronto. Il tasto Solo testo richiede la chiusura della sessione video.
Nuove domande reali vengono comunque salvate dal servizio Daily AI secondo il comportamento esistente.

ANTEPRIME LOCALI
Documenti: ricerca, filtri per ambito, dettagli e selezione di un file locale.
La selezione conserva solo nome e dimensione in memoria: nessun upload, lettura del contenuto o indicizzazione.
Conoscenza: schede moduli, bundle di esempio e modifica di bozze prompt in memoria.
Strumenti: interruttori dimostrativi che non modificano i tool del backend.
Analisi e report: percorso DVR e report esplicitamente inventato, senza eseguire valutazioni AI.
Utilizzo: filtri e grafici con numeri di esempio, non consumi del conto.
Impostazioni: bozze, piano di esempio e riepilogo dei collegamenti.
Le bozze si azzerano al ricaricamento, al logout o al cambio azienda.

MODALITA DI PRESENTAZIONE
Portale: esperienza autonoma destinata a salvatore.dailyplatform.it.
Vista CRM: contenitore gestionale dimostrativo, stessi elementi e stesso stato, senza iframe.
Il pulsante di cambio vista non apre un CRM e non trasferisce credenziali.

FUTURA INTEGRAZIONE NATIVA
I moduli UI separati costituiscono la base da portare nei componenti del framework CRM confermato.
Prima dell'inserimento effettivo occorre adattare il montaggio/smontaggio dei componenti,
isolare gli stili nel design system del CRM e collegare esplicitamente il contratto di sessione.
L'attuale shell usa un'unica istanza della pagina e alcuni ID DOM condivisi: non e un widget multi-istanza pronto da montare arbitrariamente.
Non occorre riscrivere le regole AI nel frontend. Il backend continua a verificare dati e autorizzazioni.
L'esperienza grafica puo essere validata qui prima di modificare qualunque repository applicativo Daily.

RIPRISTINO
La copia della UI precedente e conservata fuori dalla root pubblica in output/avatar-ui-backup-20261022.
Non fa parte del pacchetto di distribuzione e non contiene la configurazione privata.
Il dominio pubblico continua a usare il server PHP e il tunnel del PC fino a un trasferimento esplicito su Linux.

FONT E DIPENDENZE
LiveKit e incluso in vendor/. Le icone sono locali. Nessun framework o build npm necessario per questa anteprima.
I font DM Sans e Manrope sono richiesti a Google Fonts, con font di sistema in fallback.
I servizi Daily e LiveAvatar richiedono comunque connettivita Internet.

Estensioni future

LIVEAVATAR - ESTENSIONI POSSIBILI - documentazione verificata 21/10/2026

GIA INCLUSO: login con credenziali DailyPlatform; profilo/ruoli; aziende admin; chat personali; rich text; microfono browser; testo Daily AI pronunciato da LiveAvatar; segmentazione; comandi sessione; dipendenze locali.

1. UI e CRM: pannello laterale flottante, finestra compatta, full-screen, dimensioni responsive, sottotitoli, accessibilita, avatar diverso per azienda/ruolo, lingua per utente. Sono sviluppi applicativi; non aggiungono automaticamente dati o permessi all'AI.
2. Avatar: scegliere catalogo o avatar personale creato da riprese; identita e inquadratura dipendono dal materiale/asset. Lo zoom non ricostruisce gambe o figura intera mancanti. Studio green-screen in landscape o portrait: IDs distinti, chroma-key client. L'attuale segmentazione browser e un'elaborazione locale, non un canale alfa nativo garantito.
3. Voce: selezione catalogo e regolazioni supportate dal provider; voce personalizzata/clonata autorizzata; FULL supporta import ElevenLabs, Fish Audio e Cartesia. Account/abbonamento e diritti sulla voce necessari. Non ancora configurati in questa versione.
4. Conversazione: sottotitoli e stati da avatar.speak_started/ended e user.transcription; interruzione al parlato dell'utente; push-to-talk nativo o dialogo continuo. Occorre impedire eco e doppia risposta, conservando Daily AI come unica fonte.
5. Latenza: risposte a frasi incrementali, coda audio e annullamento coerente, STT server/streaming piu uniforme del browser. Richiedono adattare il proxy che oggi attende la risposta completa.
6. Architettura attuale FULL pilotato: l'app chiama Daily AI, invia a LiveAvatar il testo finale. Consigliata per mantenere adesso aziende, autorizzazioni, strumenti e chat esistenti.
7. FULL con custom LLM: LiveAvatar chiama un endpoint OpenAI-compatible /chat/completions. Serve un adapter del backend Daily AI che applichi identita, azienda e cronologia per ogni sessione. Non basta passare la chiave Gemini, e non e gia incluso.
8. LITE / Avatar Only: STT, Daily AI e TTS gestiti da voi; LiveAvatar anima lo stream audio. Massimo controllo su voce, orchestrazione e trasporto; costi anche dei provider esterni. Percorsi: audio senza agent, connector ospitato, plugin LiveKit/Pipecat/Agora, agente custom in stanza LiveKit o trasporto configurato direttamente.
9. Gemini Live connector: documentato tra i connector Avatar Only. Il collegamento a Gemini Live non incorpora automaticamente retrieval, permessi e strumenti del vostro CRM. Serve collegare esplicitamente il backend Daily AI e verificare il contratto del connector.
10. Memoria: FULL offre memoria opzionale tra sessioni e transcript. Nel progetto le chat sono gia nella Daily AI: meglio mantenere un unico riferimento autorevole e separare utente/azienda/chat. Memoria LiveAvatar aggiuntiva solo con mappatura esplicita.
11. Funzioni CRM: documenti, anagrafiche, scadenze, navigazione guidata, creazione bozze, appuntamenti e ticket. Da esporre come strumenti autorizzati del backend, con conferme per azioni rilevanti; LiveAvatar e il canale di presentazione, non il controllo accessi.
12. Gestione operativa: chiusura inattivita, budget e limiti per azienda, coda sessioni, metriche latenza/costi, diagnostica WebRTC/firewall, fallback testuale, reconnect controllato, test sandbox con limiti previsti dal servizio. Richiedono ulteriori implementazioni.
13. Qualita: risoluzione 360p/480p/720p/1080p secondo configurazione corrente documentata; piu risoluzione puo aumentare latenza. H264 consigliato; resa dello scontorno dipende dall'avatar scelto e dal dispositivo.

FONTI UFFICIALI
https://docs.liveavatar.com/docs/full-mode/events
https://docs.liveavatar.com/docs/full-mode/custom-llm
https://docs.liveavatar.com/docs/full-mode/custom-tts
https://docs.liveavatar.com/docs/full-mode/configuration
https://docs.liveavatar.com/docs/core-concepts/avatars
https://docs.liveavatar.com/docs/core-concepts/memory
https://docs.liveavatar.com/docs/lite-mode/overview
https://docs.liveavatar.com/docs/lite-mode/integration-paths

Tutte le voci non elencate come gia incluse sono opzioni di estensione, non funzionalita attivate in questo pacchetto. Disponibilita e quote vanno verificate sul proprio account.