search_by_mood
Find generative art algorithms by creative mood (e.g., cosmic, minimal, chaotic) and optionally refine results with style tokens.
Instructions
Search algorithms by creative mood or visual atmosphere.
Returns a dict with:
- mood (str): the normalized mood used for the query
- style (str | null): the style refinement if provided
- profile_summary (dict): the mood's associated categories and key concepts
- results (list): ranked manifest entries matching the mood
Each mood maps to a curated set of algorithm categories, concepts, and good_for
tags. The style parameter re-ranks results by matching its tokens against all
metadata fields. When the mood is unrecognized, returns an error dict containing
'error', 'available_moods', and a 'tip'.
Prefer search_algorithms for free-text queries without a clear aesthetic direction.
Use this tool when you have a specific visual mood in mind (e.g. 'cosmic',
'minimal', 'chaotic').
Available moods: ethereal, chaotic, geometric, organic, cosmic, minimal,
generative, retro, crystalline, topological, networked, geological.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mood | Yes | Creative mood or visual atmosphere. Must be one of: ethereal, chaotic, geometric, organic, cosmic, minimal, generative, retro, crystalline, topological, networked, geological. Case-insensitive. Returns an error dict with available_moods when the value is not recognized. | |
| style | No | Optional style refinement as free-text tokens (e.g. 'fluid', 'dark', 'crystalline', 'monochrome'). Tokens are matched against algorithm metadata to boost ranking within the mood results. Omit to use the mood profile alone. | |
| limit | No | Maximum number of results to return. Accepts integers in the range 1–50. Default: 8. Results are sorted by combined mood-profile and style score. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||