Open source / Logo 3D

Il tuo logo in 3D

Una skill Claude Code che prende il logo del tuo sito e lo trasforma in un hero 3D interattivo: un vero mesh estruso in Blender, verificato pixel per pixel contro l'originale.

Gratis, licenza MIT. Richiede macOS e Claude Code.

Il logo del lupo in 3D nella landing demo

Cosa fa

Dal logo piatto a un mesh 3D vero

  • Legge SVG, PNG o il sito

    Dai in pasto il file del logo, oppure solo l'indirizzo del sito: la skill trova le forme piatte e te le mostra prima di procedere.

  • Estrude in Blender

    Il logo diventa un mesh 3D vero, non un effetto finto: costruito in Blender, con materiale, luce e profondità.

  • Verifica di fedeltà

    Visto di fronte, il logo in 3D deve coprire gli stessi pixel dell'originale entro l'1%, senza essere specchiato.

  • Intervista sul look

    Fino a cinque domande su sfondo, posizione, materiale e movimento: diventano il file di configurazione del tuo logo.

  • Motore WebGPU leggero

    Il logo dal vivo gira su un motore di circa 20 KB compressi: si muove verso il puntatore con un bagliore morbido dietro.

  • Immagine statica di riserva

    Browser o dispositivo senza WebGPU, o "riduci il movimento" attivo: il visitatore vede un'immagine statica dello stesso logo, mai una casella vuota.

Requisiti

Cosa serve sul Mac

Non li hai ancora tutti? Non serve installarli prima: la skill controlla il Mac nella prima fase e ti guida in ogni installazione.

  • macOS

    La skill installa gli strumenti con Homebrew.

  • Claude Code

    È l'ambiente in cui gira l'intera pipeline, dall'intervista alla consegna.

  • Blender 4.2 o superiore

    Costruisce il mesh e l'immagine statica di riserva.

  • Node 20 o superiore

    Compila il motore e impacchetta il risultato finale.

  • Python da 3.9 a 3.13

    Fa girare la pipeline. macOS include già il 3.9 con i developer tools.

  • Chrome o Edge, Inkscape opzionale

    Chrome o Edge per l'anteprima dal vivo; Inkscape solo se il logo ha testo vivo o linee a solo contorno.

Come si installa

Quattro righe di terminale

  1. Clona e avvia

    Da terminale, sul tuo Mac

    Clona la repo, entra nella cartella ed esegui il setup: crea l'ambiente Python in .venv/, installa i pacchetti Node e compila il motore (un minuto o due). Poi apri Claude Code.

    git clone https://github.com/marcogalluccio/logo-3d.git
    cd logo-3d
    make setup
    claude

    In Claude Code, di':

    trasforma il mio logo in 3D

    Claude risponde nella tua lingua e ti guida da lì in poi.

Il percorso

Le sei fasi

  • 1. Ambiente

    Controlla Blender, Node, Python e il browser (Chrome o Edge), e aiuta a installare quello che manca.

  • 2. Input

    Legge il tuo SVG, PNG o sito, ti mostra le forme piatte trovate e aspetta il tuo via libera.

  • 3. Intervista

    Fino a cinque domande su sfondo, posizione, materiale, movimento e interazione con la pagina, che diventano logo3d.config.json.

  • 4. Build

    Estrude il logo in Blender, renderizza l'immagine statica e passa dal controllo di fedeltà rispetto all'originale.

  • 5. Anteprima

    Apre il risultato dal vivo in Chrome su un server locale: chiedi modifiche con parole tue.

  • 6. Consegna

    Impacchetta la cartella finale, controlla che non ci sia dentro nessun percorso del tuo Mac e spiega come metterlo online.

Vuoi portarlo nel tuo team?

Insegno a lavorare con gli agenti AI, in azienda o in aula a Roma. Partiamo da strumenti come questo.