whatisgithub

What is phalar?

gladia-research-group/phalar — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

In one sentence

A research framework in Python and PyTorch that trains phase-aware neural networks to produce music embeddings for tasks like chord and beat detection.

Mindmap

mindmap
  root((PHALAR))
    What it does
      Music embeddings
      Phase aware audio model
    Tech stack
      Python
      PyTorch
      FluidSynth
    Use cases
      Chord detection
      Beat tracking
      Stem similarity
    Audience
      Researchers
      ML engineers
    Method
      Spectral pooling
      Contrastive learning
      Pretrained checkpoints

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Train music embeddings from unlabeled audio using self-supervised contrastive learning.

USE CASE 2

Use pre-trained checkpoints for downstream tasks like chord detection and beat tracking.

USE CASE 3

Compare instrument stem similarity within a music recording.

USE CASE 4

Reproduce the paper's results using the included baselines and training configuration files.

What is it built with?

PythonPyTorchFluidSynth

How does it compare?

gladia-research-group/phalar0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity4/52/54/5
Audienceresearchergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires Python 3.12, PyTorch, and optionally FluidSynth, plus GPU resources for training.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

PHALAR is a research framework for teaching a machine learning model to understand music. The goal is to produce "embeddings", compact numerical representations of audio that capture what a piece of music sounds like and how it relates to other pieces. These representations can then be used for tasks like identifying chords, tracking the beat, or comparing individual instrument tracks within a recording. The project's central contribution combines two ideas. First, it applies a learned spectral pooling technique, a way of processing sound by analyzing how different frequencies relate over time. Second, it feeds the result into a phase-equivariant complex-valued neural network, designed to remain sensitive to the phase of audio signals. Phase refers to timing relationships between sound waves, many audio models discard this information, but the authors argue it matters for music understanding. The model is trained through self-supervised contrastive learning, meaning it learns from unlabeled music data by comparing similar and dissimilar audio clips rather than requiring manually labeled examples. Once trained, the embeddings can be applied to downstream tasks like chord detection, beat tracking, and stem similarity evaluation. The repository includes the official model implementation, comparison baselines, pre-trained checkpoints, and training configuration files. The code is written in Python 3.12 with PyTorch and includes optional integration with FluidSynth for synthesized audio generation. It is the official implementation accompanying a paper published at the Forty-Third International Conference on Machine Learning. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
How do I run inference with PHALAR's pre-trained checkpoints for chord detection?
Prompt 2
Explain how PHALAR's phase-equivariant complex-valued neural network differs from standard audio models.
Prompt 3
Help me set up PHALAR's training configuration to reproduce the paper's results.
Prompt 4
Show me how PHALAR's self-supervised contrastive learning produces music embeddings from unlabeled audio.

Frequently asked questions

What is phalar?

A research framework in Python and PyTorch that trains phase-aware neural networks to produce music embeddings for tasks like chord and beat detection.

What language is phalar written in?

Mainly Python. The stack also includes Python, PyTorch, FluidSynth.

What license does phalar use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is phalar to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is phalar for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.