illu - realtime conversational dynamics

4 models in a trenchcoat walk into a bar (3090 edition)

usage

clone the repo and use uv or something:

uv venv --python 3.12
uv pip install -r requirements.txt
uv run python -- illu.py

or this which basically does that:

make

have fun

configuration

it checks OPENAI_API_KEY, OPENAI_BASE_URL, and OPENAI_MODEL env vars to configure the LLM used. defaults to an api on localhost:8000 (if unset) to make it convenient for me personally.

resource reqs

~6.5 GB VRAM + whatever your LLM uses if you run that locally