FunkLab Studio

Ferramenta de produção musical assistida para funk, phonk e tech house.

DevFlow Labs · Documentação · Roadmap

---

O que é o FunkLab?

FunkLab Studio é um DAW companion que acelera o início da produção musical. Ele gera sketches, basslines e grooves em segundos, com foco em funk brasileiro, phonk e tech house.

Principais recursos

• Sketch Generator — Gera múltiplas ideias de uma vez, variando grooves e basslines
• Bassline Generator — Linhas de baixo MIDI com padrões da biblioteca
• Análise de áudio — Extrai BPM, swing, densidade e padrões de referências
• Reference Lab — Gera referências musicais via Suno API (módulo opcional)
• Biblioteca integrada — Presets, grooves e bass patterns prontos
• Exportação — MIDI e JSON para uso em qualquer DAW

Diferencial

Não existe produto equivalente focado em groove generation para esses estilos. O FunkLab acelera o sketch e a estrutura musical.

---

Começando

Pré-requisitos

• Python 3.10+
• Node.js 18+ (para a UI)

Instalação

# Clone o repositório
git clone https://github.com/devflowlabs/funklab.git
cd funklab

# Ambiente Python
python -m venv venv
source venv/bin/activate  # Linux/macOS
# ou: venv\Scripts\activate  # Windows

pip install -r requirements.txt

Rodando o projeto

Componente	Comando	URL
API	uvicorn api.server:app --reload	http://localhost:8000
UI	cd ui && npm install && npm run dev	http://localhost:3000
Docs da API	—	http://localhost:8000/docs

A UI requer a API rodando. Configure NEXT_PUBLIC_API_URL em ui/.env.local se a API estiver em outra URL.

---

Uso

CLI

# Gerar sessão com 8 sketches (mandelão, 130 BPM)
funklab session --style mandelao --bpm 130 --count 8

# Gerar projeto único
funklab new --style funk130

# Gerar batch de projetos
funklab batch --style phonk --count 10

# Analisar áudio de referência
funklab analyze referencia.wav

# Gerar bassline MIDI isolada
funklab bassline --key C --pattern mandelao_root --length 16

# Organizar samples
funklab organize-samples --src samples_raw --dst samples

API REST

Método	Endpoint	Descrição
POST	/api/v1/generate/session	Gera sessão com N sketches
POST	/api/v1/generate/bassline	Gera bassline MIDI
POST	/api/v1/analyze/audio	Analisa áudio (upload)
GET	/api/v1/library/grooves	Lista grooves
GET	/api/v1/library/bass-patterns	Lista bass patterns
GET	/api/v1/library/presets	Lista presets
POST	/api/v1/idea/generate	Gera referência via Suno (Reference Lab)
GET	/api/v1/idea/{id}	Status da referência

Presets disponíveis

Preset	BPM	Estilo
mandelao	130	Funk brasileiro
funk130	130	Funk
funk-techhouse	126	Tech house
phonk	140	Phonk

---

Reference Lab (Suno API)

Módulo opcional de ideação: gera referências musicais via Suno API.

1. Obtenha uma API key em sunoapi.org/api-key
2. Crie .env a partir de .env.example e defina SUNO_API_KEY
3. As rotas /api/v1/idea/* ficam disponíveis

Sem a chave, as rotas retornam 503.

---

Estrutura do Projeto

funklab/
├── api/                    # API FastAPI
│   ├── integrations/       # Suno client (Reference Lab)
│   ├── routes_*.py
│   └── engine_service.py
├── core/                   # Engine musical
│   ├── groove_analyzer.py
│   ├── bass_generator.py
│   ├── template_builder.py
│   └── musicality.py
├── library/                # Dados (presets, grooves, bass patterns)
├── cli/                    # Interface de linha de comando
├── ui/                     # Interface web (Next.js)
├── projects/               # Saída de sessões e referências
├── docs/                   # Documentação técnica
└── experiments/            # Experimentos e validações

---

Documentação

Documento	Descrição
PRODUCT_BLUEPRINT.md	Visão do produto e arquitetura
ROADMAP.md	Plano de evolução 3.5 → 4.5
docs/SUNO_INTEGRATION_DESIGN.md	Design da integração Suno

---

Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md para diretrizes.

---

Licença

Este projeto é licenciado sob a Licença MIT.

---

DevFlow Labs — Produtos SaaS e soluções digitais