Saltar para o conteúdo principal
Versão: 2.0.0

IA do StoryWeaver

A IA do StoryWeaver é o seu copiloto criativo, ajudando-o a transformar ideias incipientes em histórias completas. Crie personagens únicos, esculpa mundos imersivos e crie enredos convincentes com o nosso assistente inteligente de criação de histórias. Construído com Next.js, Tailwind CSS, shadcn/ui, e alimentado pela API LLM de Gaia.

imagem

informação

O código-fonte completo e as instruções detalhadas para configurar e executar este exemplo podem ser encontrados no repositório Gaia Cookbook.

Caraterísticas

  • Da ideia à história: Introduza a ideia central da sua história, o género, a duração pretendida e detalhes opcionais como o protagonista, o conflito, a vibração do mundo e o tom.
  • Geração alimentada por IA: Utiliza um grande modelo de linguagem (através da API compatível com OpenAI do Gaia) para criar histórias únicas.
  • Suporte a Markdown: Exibe histórias geradas com formatação de texto rico.
  • Transferir como imagem: Guarde as suas histórias favoritas como imagens PNG.
  • Partilha social: Partilhe rapidamente links para a sua aplicação (os utilizadores podem anexar a imagem da sua história descarregada) no X (Twitter), LinkedIn e Facebook.
  • Interface de utilizador elegante: Interface moderna e reactiva construída com shadcn/ui e Tailwind CSS.

Pilha tecnológica

  • Estrutura: Next.js (router de aplicações)
  • Linguagem: TypeScript
  • Estilo: Tailwind CSS
  • Componentes da IU: shadcn/ui
  • Gestão de formulários: React Hook Form e Zod
  • Integração LLM: openai pacote npm configurado para API de Gaia
  • Renderização Markdown: react-markdown
  • HTML para imagem: dom-para-imagem-mais
  • Ícones: reação de lucidez

Começar a trabalhar

Estas instruções permitir-lhe-ão obter uma cópia do projeto em funcionamento na sua máquina local para fins de desenvolvimento e teste.

Pré-requisitos

Configuração e instalação

  1. Clonar o repositório:

    git clone https://github.com/harishkotra/story-weaver-ai.git
    cd story-weaver-ai
  2. Instalar dependências:

    npm install
    # ou
    yarn install
  3. Configurar variáveis de ambiente: Criar um .env.local na raiz do projeto. Este ficheiro é ignorado pelo Git e é utilizado para a configuração do ambiente local.

    cp .env.example .env.local

    Agora, abra .env.local e adicione a sua chave API:

    # .env.local

    # Obrigatório: Sua chave de API para o serviço Gaia LLM (ou outra API compatível com OpenAI)
    GAIA_API_KEY="sua_chave_de_api_real_gaia_aqui"

    # Opcional: se Gaia alterar o seu ponto de extremidade ou se utilizar um serviço compatível diferente
    # A predefinição é "https://llama70b.gaia.domains/v1" se não for definida
    GAIA_API_ENDPOINT="https://your-custom-openai-compatible-endpoint/v1"
    GAIA_API_MODEL="llama70b"

    Importante: Substituir "your_actual_gaia_api_key_here" com a sua verdadeira chave API. (Obter um aqui)

  4. Inicializar o shadcn/ui (se precisar de adicionar mais componentes): Enquanto o projeto estiver configurado, se pretender adicionar mais componentes shadcn/ui mais tarde, poderá ser necessário executar o init (embora já deva estar configurado):

    npx shadcn@latest init

    Siga os avisos, aceitando as predefinições ou alinhando com a configuração de projeto existente (src/app/globals.css, tailwind.config.ts, nomes por que é conhecida @/componentes e @/lib/utils).

Executar a aplicação localmente

  1. Inicie o servidor de desenvolvimento:

    npm run dev
    # ou
    yarn dev
  2. Abra o seu browser: Navegar para http://localhost:3000.

Agora deve ver a aplicação StoryWeaver AI a funcionar!

informação

O código-fonte completo e as instruções detalhadas para configurar e executar este exemplo podem ser encontrados no repositório Gaia Cookbook.