Skip to content

arthr/ghostwriter-ai

Repository files navigation

Ghostwriter AI - Do Pixel à Palavra

Ghostwriter AI

Transforme suas imagens em histórias imersivas

Faça upload de uma foto e deixe a IA revelar a história escondida nela


Sobre o Projeto

Ghostwriter AI é uma experiência de escrita criativa onde você se torna o curador de histórias. Basta enviar uma imagem - uma paisagem misteriosa, um retrato intrigante, uma cena urbana - e o seu escritor fantasma pessoal irá analisar cada detalhe para criar um parágrafo de abertura atmosférico e envolvente.

Não é apenas texto. Você pode ouvir a história sendo narrada com uma voz expressiva, e ainda conversar com um assistente que conhece profundamente o universo que foi criado, respondendo perguntas sobre personagens, cenários e atmosfera.

O que você pode fazer

  • Upload de Imagens - Arraste ou selecione qualquer imagem que desperte sua imaginação
  • Geração de Histórias - Receba um parágrafo de abertura criativo e imersivo baseado na cena
  • Narração em Voz Alta - Ouça a história sendo contada com entonação dramática
  • Chat Interativo - Explore o mundo da história fazendo perguntas ao assistente
  • Múltiplos Idiomas - Disponível em Português, Inglês, Espanhol, Francês e Alemão

Como Usar

Pré-requisitos

  • Node.js instalado (versão 18 ou superior recomendada)
  • Uma chave de API do Google Gemini

Instalação

  1. Clone ou baixe o projeto

  2. Instale as dependências:

    npm install
  3. Crie um arquivo .env.local na raiz do projeto e adicione sua chave de API:

    GEMINI_API_KEY=sua_chave_aqui
    
  4. Inicie o servidor de desenvolvimento:

    npm run dev
  5. Acesse http://localhost:3000 no seu navegador


Como Funciona

    Imagem          Análise IA           História
  +--------+      +----------+      +-------------+
  |  Foto  | ---> |  Gemini  | ---> |  Parágrafo  |
  +--------+      +----------+      +-------------+
                                           |
                       +-------------------+-------------------+
                       |                                       |
                       v                                       v
                 +----------+                           +------------+
                 | Narração |                           |    Chat    |
                 | em Voz   |                           | Interativo |
                 +----------+                           +------------+
  1. Você envia uma imagem - pode ser qualquer foto que tenha uma história para contar
  2. A IA analisa a cena - iluminação, humor, detalhes visuais, tudo é considerado
  3. Uma história nasce - um parágrafo de abertura é escrito no idioma escolhido
  4. Explore o universo - ouça a narração ou converse sobre o mundo criado

Tecnologias

  • React 19 - Interface de usuário
  • TypeScript - Tipagem estática
  • Vite - Build tool ultrarrápido
  • Tailwind CSS - Estilização
  • Google Gemini API - Geração de texto, análise de imagem e síntese de voz

Estrutura do Projeto

ghostwriter-ai/
├── src/
│   ├── components/
│   │   ├── ChatInterface.tsx   # Chat interativo
│   │   ├── Icons.tsx           # Ícones SVG
│   │   ├── StoryView.tsx       # Visualização da história
│   │   └── Uploader.tsx        # Upload de imagens
│   ├── services/
│   │   ├── audioUtils.ts       # Player de áudio PCM
│   │   └── geminiService.ts    # Integração com Gemini API
│   ├── App.tsx                 # Componente principal
│   ├── index.tsx               # Entry point
│   └── types.ts                # Tipos e traduções
├── assets/                     # Imagens e recursos estáticos
├── index.html                  # HTML principal
├── vite.config.ts              # Configuração do Vite
└── tsconfig.json               # Configuração TypeScript

Licença

Este projeto foi criado para fins de demonstração e aprendizado.


"Toda imagem tem uma história. Deixe-me contá-la para você."

Do Pixel à Palavra. Sua foto conta a história.

About

Uma interface imersiva de escrita criativa onde a IA analisa suas imagens para redigir histórias atmosféricas como *ghostwriter*, com narração expressiva.

Resources

Stars

Watchers

Forks

Contributors