Skip to content

photografereth/lyrics_prompter

Repository files navigation

🎵 Lyrics Prompter

Um agente especializado em criação de letras musicais em português brasileiro, com interface de chat e canvas para formatação otimizada para o Suno AI.

✨ Funcionalidades

🤖 IA Conversacional

  • Chat inteligente para criação colaborativa de letras
  • Geração automática baseada em temas, gêneros e estilos
  • Sugestões contextuais e melhorias em tempo real
  • Suporte para diversos gêneros musicais brasileiros

✏️ Editor Avançado

  • Editor visual com análise de rimas e métricas
  • Estruturação automática (versos, refrãos, pontes)
  • Contador de sílabas e análise de ritmo
  • Sugestões de rimas em português

🎯 Formatação Suno AI

  • Export otimizado para Suno AI
  • Tags automáticas baseadas no conteúdo
  • Estrutura formatada para IA musical
  • Cópia direta para clipboard

📂 Gerenciamento de Projetos

  • Múltiplos projetos com histórico
  • Versionamento automático
  • Preview em tempo real
  • Exportação em diversos formatos

🚀 Começando

Pré-requisitos

  • Node.js 18+
  • npm ou yarn

Instalação

  1. Clone o repositório:
git clone <repo-url>
cd lyrics_prompter
  1. Instale as dependências:
npm install
  1. Configure as variáveis de ambiente:
cp .env.local.example .env.local
# Edite .env.local e adicione sua chave API do OpenAI
  1. Execute o servidor de desenvolvimento:
npm run dev
  1. Abra http://localhost:3000 no navegador.

⚙️ Configuração

Chave API do OpenAI

Para usar as funcionalidades completas de IA, você precisa configurar uma chave API do OpenAI:

  1. Crie uma conta em OpenAI
  2. Gere uma chave API
  3. Adicione no arquivo .env.local:
NEXT_PUBLIC_OPENAI_API_KEY=sua_chave_aqui

Nota: Sem a chave API, a aplicação funcionará em modo demo com letras de exemplo.

🎯 Como Usar

1. Criando um Projeto

  • Clique em "Novo Projeto" na sidebar
  • Digite um nome para seu projeto
  • Comece a criar no chat ou editor

2. Chat de Criação

  • Descreva o tema, gênero ou estilo desejado
  • A IA irá gerar sugestões e letras
  • Refine através da conversa
  • As letras aparecem automaticamente no editor

3. Editor de Letras

  • Adicione versos, refrões e outras seções
  • Use a análise de rimas para melhorar a qualidade
  • Visualize sugestões em tempo real
  • Organize a estrutura da música

4. Preview e Export

  • Visualize a formatação final
  • Copie diretamente para o Suno AI
  • Exporte em formato texto
  • Compartilhe seu trabalho

🛠️ Tecnologias

  • Frontend: Next.js 15, React 18, TypeScript
  • Styling: Tailwind CSS
  • Estado: Zustand com persistência
  • IA: OpenAI GPT-3.5-turbo
  • UI: Lucide Icons, Framer Motion
  • Canvas: Konva.js para edição visual

📁 Estrutura do Projeto

src/
├── app/                 # App Router (Next.js)
├── components/          # Componentes React
│   ├── chat/           # Sistema de chat
│   ├── editor/         # Editor de letras
│   ├── preview/        # Preview e export
│   ├── sidebar/        # Navegação de projetos
│   └── ui/             # Componentes base
├── services/           # Serviços (IA, análise, formatação)
├── store/              # Estado global (Zustand)
├── types/              # Definições TypeScript
└── utils/              # Utilitários

🎨 Gêneros Suportados

  • 🥁 Samba
  • 🎸 Bossa Nova
  • 🎵 MPB (Música Popular Brasileira)
  • 🎸 Rock
  • 🎤 Pop
  • 🕺 Funk
  • 🎤 Rap/Hip-Hop
  • 🤠 Sertanejo
  • 🪗 Forró
  • 🎺 Axé
  • 🎶 Pagode
  • 🌴 Reggae

🚀 Deploy

Vercel (Recomendado)

  1. Conecte seu repositório ao Vercel
  2. Configure as variáveis de ambiente
  3. Deploy automático

Outros Provedores

# Build para produção
npm run build

# Start em produção
npm start

🤝 Contribuindo

  1. Fork o projeto
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

🛡️ Segurança

  • ✅ Criação de letras originais
  • ✅ Análise de estruturas líricas
  • ✅ Ferramentas educativas
  • ❌ Reprodução de material protegido
  • ❌ Conteúdo ofensivo ou discriminatório

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para detalhes.

🙏 Agradecimentos

  • Comunidade musical brasileira
  • Desenvolvedores open source
  • OpenAI pela tecnologia de IA
  • Todos os testadores e colaboradores

Feito com ❤️ para músicos brasileiros 🇧🇷

About

Um agente especializado em criação de letras musicais em português brasileiro, com interface de chat e canvas para formatação otimizada para o Suno AI.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages