tomusic.ai - Python Library

This package provides an automated interface to interact with and showcase the capabilities of tomusic.ai. It simplifies integration with the tomusic.ai platform through a Python-based API.

Installation

To install the tomusic.ai library, use pip: bash pip install tomusic.ai

Basic Usage

Here are a few examples demonstrating how to use the tomusic.ai library:

1. Generating a Simple Melody: python from tomusic import ai

Initialize the API client (replace with your actual API key)

client = ai.Client(api_key="YOUR_API_KEY")

Generate a melody with default parameters

melody = client.generate_melody()

Print the generated melody (format depends on the API)

print(melody)

2. Composing a Song with Specified Parameters: python from tomusic import ai

Initialize the API client (replace with your actual API key)

client = ai.Client(api_key="YOUR_API_KEY")

Define parameters for the song generation

params = { "genre": "Jazz", "tempo": 120, "key": "C Major", "duration": 60, # seconds }

Generate a song based on the specified parameters

song = client.generate_song(params)

Save the generated song to a file (format depends on the API - e.g., MIDI, MP3)

client.save_song(song, "jazz_song.mid")

3. Analyzing an Existing Piece of Music: python from tomusic import ai

Initialize the API client (replace with your actual API key)

client = ai.Client(api_key="YOUR_API_KEY")

Analyze a music file

analysis_result = client.analyze_music("path/to/your/music.mp3")

Print the analysis results (e.g., key, tempo, genre)

print(analysis_result)

4. Generating Variations of an Existing Melody: python from tomusic import ai

Initialize the API client (replace with your actual API key)

client = ai.Client(api_key="YOUR_API_KEY")

Load an existing melody (replace with your melody data)

original_melody = "C-D-E-F-G-A-B-C"

Generate variations of the melody

variations = client.generate_melody_variations(original_melody, num_variations=3)

Print the generated variations

for i, variation in enumerate(variations): print(f"Variation {i+1}: {variation}")

5. Generating Accompaniment for a Melody: python from tomusic import ai

Initialize the API client (replace with your actual API key)

client = ai.Client(api_key="YOUR_API_KEY")

Load an existing melody (replace with your melody data)

melody = "C-D-E-F-G-A-B-C"

Generate accompaniment for the melody

accompaniment = client.generate_accompaniment(melody, style="Piano")

Save the generated accompaniment (format depends on the API)

client.save_accompaniment(accompaniment, "piano_accompaniment.mid")

Features

• Melody Generation: Generate original melodies based on various parameters.
• Song Composition: Compose full songs with specified genres, tempos, and keys.
• Music Analysis: Analyze existing music files to extract key information.
• Melody Variations: Create variations of existing melodies.
• Accompaniment Generation: Generate accompaniment for melodies.
• Easy Integration: Seamlessly integrate with the tomusic.ai platform.
• Parameter Customization: Fine-tune music generation with customizable parameters.
• File Saving: Save generated music in various formats (e.g., MIDI, MP3).

License

MIT License

This project is a gateway to the tomusic.ai ecosystem. For advanced features and full capabilities, please visit: https://tomusic.ai/