Hugging Face's logo

Spaces:
pachet
/
hexachords
Sleeping

App Files Community
hexachords
File size: 1,879 Bytes
4719913
 
 
 
 
 
 
 
 
 
 
 
 
94f4538
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
---
title: Hexachords
emoji: 🌍
colorFrom: pink
colorTo: pink
sdk: gradio
sdk_version: 5.21.0
app_file: app.py
pinned: false
license: mit
short_description: simple generation of hexachords
---

# Hexachords

A musical composition tool that generates and manipulates hexachords - six-note musical structures.
This Hugging Face Space provides an interactive interface for exploring and creating music with hexachords.
Collaboration with Jean-Louis Hennequin who uses hexachords for film music composition.

## Features

- Generate hexachords based on musical parameters
- (soon) Create musical compositions using hexachordal structures
- (soon) Export compositions to MIDI format
- (soon) Interactive web interface for real-time experimentation

## Installation & Setup

To run this project locally:

1. Clone the repository:
   ```bash
   git clone https://huggingface.co/spaces/fpachet/hexachords
   cd hexachords
   ```

2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

3. Download a soundfont:
   - You'll need a soundfont (.sf2) file for audio playback
   - Place it in the root directory as `soundfont.sf2`
   - Note: The soundfont file is not included in the repository due to size limitations

## Usage

1. Local Development:
   ```bash
   python app.py
   ```

2. Web Interface:
   - Visit the Hugging Face Space to use the online version
   - No installation required for the web interface

## Important Note

This project requires a soundfont (.sf2) file for audio playback. Due to file size limitations, the soundfont is not included in the repository. You'll need to:

1. Download a compatible soundfont file
2. Rename it to `soundfont.sf2`
3. Place it in the project root directory

Recommended soundfonts:
- General User GS
- FluidR3_GM

## License

This project is licensed under the MIT License - see the LICENSE file for details.