store/data/tools/ambient-sound-composer.json

{
  "id": "ambient-sound-composer",
  "name": "Ambient Sound Composer",
  "description": "This tool functions as a personal soundscape generator, creating single ambient audio experiences tailored to your specific prompts. By leveraging a Large Language Model (LLM), it intelligently selects and mixes sounds from a library to produce a unique MP3 file that matches the mood or environment you describe.\n\n(Note: To build longer evolving sound journeys, use the tool 'ambient sound journey composer', which uses the present tool under the hood.)\n\n### How to Use the Tool:\n\nThis tool offers a straightforward, step-by-step process for creating your ideal ambient soundscape:\n\n1.  **Download the Sound Library**: Before you can generate any soundscapes, you must first download the necessary audio assets. To do this, simply run the tool with the `download_assets` option set to `True`. This will fetch the default sound library from a GitHub repository and store it on your local machine. The tool supports .mp3 and .wav sound files.\n\n2.  **Customize with Your Own Sounds (Optional)**: You have the creative freedom to expand the sound library. To add your own audio, just place any MP3 or WAV files into the designated `assets_folder`. You can also create subfolders to organize your sounds by category. For best results, use only a 2 level depth (categories, subcategories, no more). The tool will automatically detect and integrate these new files, making them available for your soundscapes.\n\n3.  **Generate Your Soundscape**: Once your sound library is ready, you can start creating. Provide a descriptive `prompt` detailing the type of ambient sound you want (e.g., \"a peaceful forest with a gentle stream and distant birds\"). The tool will then generate a custom MP3 file based on your description.\n\n4.  **Explore Your Sound Options (Optional)**: If you're unsure what sounds are available or want to get ideas for your prompts, you can set the `show_available_sounds` option to `True`. This will provide a complete list of all the sounds in your library, including any you've added yourself, without generating an audio file.",
  "version": "1.0.0",
  "author": "hanzo.ai",
  "homepage": "local:::__hanzo:::ambient_sound_composer",
  "license": "MIT",
  "category": "Entertainment",
  "tags": [
    "soundscape",
    "ambient",
    "sound",
    "relax"
  ],
  "icon": "https://shinkai-store.54bf1bf573b3e6471e574cc4d318db64.r2.cloudflarestorage.com/local%3A%3A%3A__hanzo%3A%3A%3Aambient_sound_composer/icon.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=0cfac524550f96df0a110872ae39d2e3%2F20251105%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20251105T142021Z&X-Amz-Expires=86400&X-Amz-Signature=bc9ac385807edd9a1800cb2515eda069aa2377cfd9a04e29d96ef388cc94efde&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
  "screenshots": [
    "https://shinkai-store.54bf1bf573b3e6471e574cc4d318db64.r2.cloudflarestorage.com/local%3A%3A%3A__hanzo%3A%3A%3Aambient_sound_composer/banner.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=0cfac524550f96df0a110872ae39d2e3%2F20251105%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20251105T142021Z&X-Amz-Expires=86400&X-Amz-Signature=ef338abfcdae0aef01eed02e2cf06d47b1aa1b30651b80d59fa20511a88f9fac&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
  ],
  "installCommand": "",
  "mcpConfig": {
    "command": "any",
    "args": [
      "local:::__hanzo:::ambient_sound_composer"
    ],
    "env": {}
  },
  "downloads": 0,
  "createdAt": "2025-10-12T17:03:11.808Z",
  "updatedAt": "2025-10-12T17:03:11.808Z",
  "type": "Tool",
  "toolLanguage": "Python",
  "operatingSystem": [
    "linux",
    "macos",
    "windows"
  ],
  "runner": "any",
  "featured": true,
  "price": 0
}