Skip to content

Commit 619cb41

Browse files
committed
docs
1 parent fb0e17a commit 619cb41

File tree

2 files changed

+81
-4
lines changed

2 files changed

+81
-4
lines changed

README.md

Lines changed: 80 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,6 @@ uv run python src/agent.py console
4343

4444
## Web playground
4545

46-
## Web frontend
47-
4846
This agent is compatible with the [LiveKit Agents Playground](https://agents-playground.livekit.io).
4947

5048
To run the agent for the playground, use the `dev` subcomand:
@@ -81,4 +79,83 @@ To run the tests in a CI environment, you must also [add repository secrets](htt
8179

8280
## Deploying to production
8381

84-
This project is production-ready and includes a working `Dockerfile`. To deploy it to LiveKit Cloud or another environment, see the [deploying to production](https://docs.livekit.io/agents/ops/deployment/) guide.
82+
This project is production-ready and includes a working `Dockerfile`. To deploy it to LiveKit Cloud or another environment, see the [deploying to production](https://docs.livekit.io/agents/ops/deployment/) guide.
83+
84+
## Models
85+
86+
This project uses models from AssemblyAI and Rime, as well as GPT-4o-mini from Azure OpenAI. By default, these are served through early-access to LiveKit Inference and no extra account is required.
87+
88+
### AssemblyAI customization
89+
90+
To customize the AssemblyAI model, while still using LiveKit Cloud, you can use the following session setup instead of the version above:
91+
92+
```python
93+
from livekit.agents import inference
94+
95+
session = AgentSession(
96+
stt=inference.STT(model="assemblyai", extra_kwargs={ ... })
97+
)
98+
```
99+
100+
Refer to the [source code](https://github.com/livekit/agents/blob/main/livekit-agents/livekit/agents/inference/stt.py#L57) for available parameters (docs for LiveKit Inference are coming soon)
101+
102+
#### AssemblyAI plugin
103+
104+
To use your own AssemblyAI account, or access additional features, use the AssemblyAI plugin:
105+
106+
```shell
107+
uv add livekit-agents[assemblyai]
108+
```
109+
110+
```python
111+
from livekit.plugins import assemblyai
112+
113+
session = AgentSession(
114+
stt=assemblyai.STT()
115+
)
116+
```
117+
118+
Refer to the [plugin documentation](https://docs.livekit.io/agents/integrations/stt/assemblyai/) for more information.
119+
120+
### Rime customization
121+
122+
To use a different Rime voice, while still using LiveKit Cloud, just change the voice name after the colon:
123+
124+
```python
125+
session = AgentSession(
126+
tts="rime/arcana:andromeda"
127+
)
128+
```
129+
130+
Refer to the [Rime voices list](https://docs.rime.ai/api-reference/voices) for more information.
131+
132+
#### Rime plugin
133+
134+
To use your own Rime account, or access additional features, use the Rime plugin:
135+
136+
```shell
137+
uv add livekit-agents[rime]
138+
```
139+
140+
```python
141+
from livekit.plugins import rime
142+
143+
session = AgentSession(
144+
tts=rime.TTS(model="arcana", speaker="andromeda")
145+
)
146+
```
147+
148+
Refer to the [plugin documentation](https://docs.livekit.io/agents/integrations/tts/rime/) for more information.
149+
150+
151+
## Other large language models
152+
153+
Refer to the [source code](https://github.com/livekit/agents/blob/main/livekit-agents/livekit/agents/inference/llm.py) for available models (LiveKit Inference docs are coming soon).
154+
155+
```python
156+
session = AgentSession(
157+
llm="azure/gpt-4o-mini"
158+
)
159+
```
160+
161+
Or, use an [LLM plugin](https://docs.livekit.io/agents/integrations/llm/) for a wider range of models and more configuration options.

src/agent.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ async def entrypoint(ctx: JobContext):
8585

8686
# This starter template uses Rime via LiveKit Cloud
8787
# To change the voice, alter the voice name (currently "luna") after the colon.
88-
# See available voices at https://docs.livekit.io/agents/integrations/tts/rime/#voices
88+
# See available voices at https://docs.rime.ai/api-reference/voices
8989
#
9090
# Or, to use your own Rime account:
9191
# 1. Install livekit-agents[rime]

0 commit comments

Comments
 (0)