Skip to content

Recommend GPT-Live for realtime, and upgrade to Agents 1.9 - #64

Merged
bcherry merged 7 commits into
mainfrom
bcherry/practical-cerf-n6iafl
Sep 22, 2026
Merged

bcherry merged 7 commits into
mainfrom
bcherry/practical-cerf-n6iafl

Conversation

@bcherry

@bcherry bcherry commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Summary

Two things, both aimed at a fresh clone starting where the docs say it should:

  • The commented-out realtime instructions pointed at the OpenAI Realtime API, which is no longer the speech-to-speech model LiveKit recommends first. They now describe GPT-Live.
  • Dependencies were several minor releases behind. @livekit/agents moves 1.6.3 → 1.9.0, and the plugins move with it.

Dependency notes

  • @livekit/rtc-node stays on the 0.13 line (→ ^0.13.35) on purpose. npm's latest for it is 1.0.0, but Agents 1.9.0 peer-requires ^0.13.34 and the ai-coustics plugin requires ^0.13.24, so 1.0.0 would break the install.
  • @livekit/plugins-ai-coustics 0.3 narrowed audioEnhancement's model from a string to the EnhancerModel enum, so main.ts now passes EnhancerModel.QuailVfS. That matches how the Python starter already names the model.

How to verify

  1. pnpm install && pnpm run typecheck && pnpm run lint && pnpm run format:check — all clean.
  2. pnpm run dev and speak to the agent to confirm the pipeline and noise cancellation still work. This is the part CI can't cover: the enum change touches the audio path, and a wrong member would still typecheck.
  3. Optionally follow the realtime comments in src/agent.ts to swap in openai.realtime.GPTLiveModel and confirm a realtime session connects.

Notes

The pnpm-lock.yaml stays untracked, as the template intends.

https://claude.ai/code/session_015wTPF2dbiDVMRwkQCpWr6o

claude and others added 5 commits September 18, 2026 16:05
The commented-out realtime instructions pointed at the OpenAI Realtime
API, which is no longer the speech-to-speech model LiveKit recommends
first.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015wTPF2dbiDVMRwkQCpWr6o
Raise agents from 1.6.3 to the current release. Agents 1.9.0 peer-requires
@livekit/rtc-node ^0.13.34, so raise that floor to match — npm's latest
rtc-node is 1.0.0, which neither agents nor the ai-coustics plugin accepts,
so this stays on the 0.13 line deliberately.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015wTPF2dbiDVMRwkQCpWr6o
Both sides bumped the same dependency floors. Kept the local versions,
which are strictly newer on every line and already include the
@livekit/agents 1.9.0 upgrade the remote commit was making; rtc-node
stays on the 0.13 line, as that commit intended.
@bcherry bcherry changed the title Update realtime model documentation and API references Change realtime example to GPT-Live Sep 18, 2026
State the current versions outright rather than leaving the ranges to
float onto them. rtc-node stays on the 0.13 line on purpose: npm's latest
is 1.0.0, which neither @livekit/agents nor the ai-coustics plugin accepts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015wTPF2dbiDVMRwkQCpWr6o
The 0.3 plugin narrowed `audioEnhancement`'s `model` from a string to the
`EnhancerModel` enum, so the string literal no longer typechecks. This also
brings the Node starter in line with the Python one, which already names the
model through the enum.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015wTPF2dbiDVMRwkQCpWr6o
@bcherry bcherry changed the title Change realtime example to GPT-Live Recommend GPT-Live for realtime, and upgrade to Agents 1.9 Sep 22, 2026
@bcherry
bcherry merged commit 8310791 into main Sep 22, 2026
5 checks passed
@bcherry
bcherry deleted the bcherry/practical-cerf-n6iafl branch September 22, 2026 16:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants