# AGENTS.md · flambo/semantifx

[View on GitCafe](https://git.cafe/flambo/semantifx/blob/HEAD/AGENTS.md)

Repository: [flambo/semantifx](https://git.cafe/flambo/semantifx)

Visibility: public

Requested revision: HEAD

Commit: 4278b261aaa6bf8a49c6d9366c93e1cf51c25c4b

Blob: c3f2eb3b9eff2bf787b37f76438a54607a4a48e0

Size: 767 bytes

[Immutable source](https://git.cafe/flambo/semantifx/blob/4278b261aaa6bf8a49c6d9366c93e1cf51c25c4b/AGENTS.md?format=markdown)

```
# SemantiFX

Text prompt in, editable effect-chain configuration out. A JUCE plugin
(`plugin/`, built and iterated on macOS) talks to a Python inference worker
(`inference/`, developed on Linux with CUDA) over a JSONL protocol. Chain
optimization tunes a fixed chain's parameters with a CLAP loss. Chain assembly
picks and orders the effects with TypeSafe Jev.

Read `CONTEXT.md` for the vocabulary before naming anything.

## Working here

- Solo repo. Work directly on `main`; no pull requests.
- Python: `cd inference && .venv/bin/python -m unittest discover -s tests`.
  Set `SEMANTIFX_RUN_MODEL_TESTS=1` to include the golden CLAP test.
- API keys live in `.env` at the repo root (gitignored). Never print them.
- Experiment write-ups go in `docs/experiments/`.

```