# takiy

> `takiy` (Quechua: *to sing*). Music in Rust — synthesis, sequencing, playback — on [Llimphi](https://github.com/tawasuyu/llimphi).

![the takiy sequencer's piano roll: a pitch×beats grid with four colored tracks — high orange arpeggio, blue melody with a selected note, pink chord pads, low green bass — a highlighted loop band, a yellow playback cursor and volume/pan automation curves with draggable dots](https://tawasuyu.net/02_ruway/takiy/pantallazo.png)

Designed to run in real time (measurable xruns, not hand-wavey) and to be deterministic when asked (same seed → same WAV). On top of that base the domain grew into a **generative studio**: an engine that composes a full multi-track piece from a brief, sonification of narratives, listening from existing sound, and LLM bridges that only *refine parameters* — the engines stay deterministic.

## Run

```sh
cargo run --release -p takiy-app-llimphi     # the sequencer (piano roll, automation, WAV export)
```

## Crates

| Crate | Role |
|---|---|
| [`takiy-core`](02_ruway/takiy/takiy-core/) | The score model. |
| [`takiy-synth`](02_ruway/takiy/takiy-synth/) | Synthesis. |
| [`takiy-playback`](02_ruway/takiy/takiy-playback/) | Real-time playback and offline render. |
| [`takiy-midi`](02_ruway/takiy/takiy-midi/) | MIDI import/export. |
| [`takiy-editor-core`](02_ruway/takiy/takiy-editor-core/) | Pure editable state of the piano roll (score + selection + active track); no audio, no UI. |
| [`takiy-proyecto`](02_ruway/takiy/takiy-proyecto/) | A takiy project with DAG versioning (content-addressed commits). |
| [`takiy-genesis`](02_ruway/takiy/takiy-genesis/) | Generative engine: from a `Brief` (key, tempo, mood, style, seed) it builds a complete multi-track piece, deterministically. |
| [`takiy-narrativa`](02_ruway/takiy/takiy-narrativa/) | Narrative → music: sonifies a `pluma` multilienzo bundle into a native score. |
| [`takiy-escucha`](02_ruway/takiy/takiy-escucha/) | The two listenings: starts from sound that already exists instead of from an intent. |
| [`takiy-ambiente`](02_ruway/takiy/takiy-ambiente/) | The desktop's soundscape, derived from agnostic ambient signals. |
| `takiy-{genesis,narrativa,escucha}-llm` | LLM bridges that refine the deterministic engines above — prose in, `Brief`/`Patch` out. |
| [`takiy-app-llimphi`](02_ruway/takiy/takiy-app-llimphi/) | The sequencer app. |

## How dependencies work

This is a clean front-door repo: it holds **only takiy's own crates**. Everything else is a git dependency on the [`tawasuyu`](https://git.tawasuyu.net/tawasuyu/tawasuyu) monorepo (the suite's source of truth), pinned to a tag — including the Llimphi UI framework. No vendoring, no duplication; the first build clones that repo and caches it.

The directory layout mirrors the monorepo (`02_ruway/takiy/…`) on purpose: the repo is regenerated from it with `scripts/actualizar-standalone.py`, so paths stay comparable between the two.

## Compatibility

- **Linux** — PulseAudio / PipeWire / ALSA · **macOS** — CoreAudio · **Windows** — WASAPI · **Wawa** — kernel driver (when ready).

## Considerations

- **Latency is first-class.** The audio loop respects the device period; it doesn't break because of the UI.
- **No VST3/AU.** The plugin catalog is the crate tree; a new synth is a new crate.
- Offline (non-realtime) render for long files: deterministic WAV/FLAC, gated in CI by the BLAKE3 hash of a canonical WAV.

## License

MIT — see [LICENSE](LICENSE).