fabricatio_yue.capabilities.genre

Genre selection capabilities for music composition.

Classes

SelectGenre

A capability class for selecting appropriate music genres based on requirements.

Module Contents

class fabricatio_yue.capabilities.genre.SelectGenre(/, **data: Any)

Bases: fabricatio_core.capabilities.usages.UseLLM

A capability class for selecting appropriate music genres based on requirements.

async select_genre(requirement: str, genre_classifier: str, genres: List[str], **kwargs: Unpack[fabricatio_core.models.kwargs_types.ChooseKwargs[str]]) → None | List[str]
async select_genre(requirement: List[str], genre_classifier: str, genres: List[str], **kwargs: Unpack[fabricatio_core.models.kwargs_types.ChooseKwargs[str]]) → List[List[str] | None]

Select appropriate music genres based on given requirements.

This method uses template-based generation to select suitable genres from a provided list based on textual requirements and a genre classifier.

Parameters:

  • requirement (str | List[str]) – Either a single requirement string or list of requirement strings describing the desired music style or characteristics.

  • genre_classifier (str) – The type or category of genres to consider (e.g., “pop”, “electronic”).

  • genres (List[str]) – List of available genres to choose from.

  • **kwargs (Unpack[ChooseKwargs[str]]) – Additional validation parameters passed to the underlying validation system.

Returns:

For single requirement: List of selected genres or None if no match. For multiple requirements: List where each element is either a list of genres or None.

Return type:

None | List[str] | List[List[str] | None]

async gather_genres(requirements: str, **kwargs: Unpack[fabricatio_core.models.kwargs_types.ChooseKwargs[str]]) → None | List[str]
async gather_genres(requirements: List[str], **kwargs: Unpack[fabricatio_core.models.kwargs_types.ChooseKwargs[str]]) → List[List[str] | None]

Gather genres from all available genre categories based on requirements.

This method iterates through all genre categories in the configuration and selects appropriate genres for each category based on the given requirements.

Parameters:

  • requirements (str | List[str]) – Either a single requirement string or list of requirement strings.

  • **kwargs (Unpack[ChooseKwargs[str]]) – Additional validation parameters.

Returns:

For single requirement: List of all selected genres from all categories or None. For multiple requirements: List where each element corresponds to gathered genres for each requirement.

Return type:

None | List[str] | List[List[str] | None]