# livekit-plugins-aliyun
适配[阿里云百炼](https://bailian.console.aliyun.com/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.6b887b08kVpe2w&tab=model#/model-market)的[livekit-agent](https://github.com/livekit/agents)框架插件。目前支持[TTS](https://bailian.console.aliyun.com/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.6b887b08kVpe2w&tab=model#/model-market?capabilities=%5B%22TTS%22%5D&z_type_=%7B%22capabilities%22%3A%22array%22%7D), [LLM](https://bailian.console.aliyun.com/?tab=model#/model-market), [STT](https://bailian.console.aliyun.com/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.6b887b08kVpe2w&tab=model#/model-market?capabilities=%5B%22ASR%22%5D&z_type_=%7B%22capabilities%22%3A%22array%22%7D)。
## 安装
```python
pip install livekit-plugins-aliyun
```
## 环境变量
- LLM, STT, TTS: `DASHSCOPE_API_KEY`
## 使用示例
以下代码展示了如何在`livekit-agent`中使用`livekit-plugins-aliyun`插件。
```python
from livekit.agents import Agent, AgentSession, JobContext, cli, WorkerOptions
from livekit.plugins import aliyun
from dotenv import load_dotenv
async def entry_point(ctx: JobContext):
await ctx.connect()
agent = Agent(instructions="You are a helpful assistant.")
session = AgentSession(
stt=aliyun.STT(model="paraformer-realtime-v2"),
tts=aliyun.TTS(model="cosyvoice-v2", voice="longcheng_v2"),
llm=aliyun.LLM(model="qwen-plus"),
)
await session.start(agent=agent, room=ctx.room)
await session.generate_reply()
if __name__ == "__main__":
load_dotenv()
cli.run_app(WorkerOptions(entrypoint_fnc=entry_point))
```
若需要使用STT热词功能，需要在`STT`插件中配置`vocabulary_id`参数。
```python
session = AgentSession(
stt=aliyun.STT(model="paraformer-realtime-v2", vocabulary_id="your_vocabulary_id"),
tts=aliyun.TTS(model="cosyvoice-v2", voice="longcheng_v2"),
llm=aliyun.LLM(model="qwen-plus"),
)
```
Raw data
{
"_id": null,
"home_page": null,
"name": "livekit-plugins-aliyun",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "audio, livekit, realtime, video, webrtc",
"author": null,
"author_email": "wangmengdi <790990241@qq.com>",
"download_url": "https://files.pythonhosted.org/packages/98/d8/cc5bbb3fa241dc9de6bfb6f66c2609c6431bf3654bec8bab3585d81f3931/livekit_plugins_aliyun-1.2.0.tar.gz",
"platform": null,
"description": "# livekit-plugins-aliyun\n\n\u9002\u914d[\u963f\u91cc\u4e91\u767e\u70bc](https://bailian.console.aliyun.com/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.6b887b08kVpe2w&tab=model#/model-market)\u7684[livekit-agent](https://github.com/livekit/agents)\u6846\u67b6\u63d2\u4ef6\u3002\u76ee\u524d\u652f\u6301[TTS](https://bailian.console.aliyun.com/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.6b887b08kVpe2w&tab=model#/model-market?capabilities=%5B%22TTS%22%5D&z_type_=%7B%22capabilities%22%3A%22array%22%7D), [LLM](https://bailian.console.aliyun.com/?tab=model#/model-market), [STT](https://bailian.console.aliyun.com/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.6b887b08kVpe2w&tab=model#/model-market?capabilities=%5B%22ASR%22%5D&z_type_=%7B%22capabilities%22%3A%22array%22%7D)\u3002\n\n## \u5b89\u88c5\n```python\npip install livekit-plugins-aliyun\n```\n\n## \u73af\u5883\u53d8\u91cf\n\n- LLM, STT, TTS: `DASHSCOPE_API_KEY`\n\n## \u4f7f\u7528\u793a\u4f8b\n\n\u4ee5\u4e0b\u4ee3\u7801\u5c55\u793a\u4e86\u5982\u4f55\u5728`livekit-agent`\u4e2d\u4f7f\u7528`livekit-plugins-aliyun`\u63d2\u4ef6\u3002\n\n```python\nfrom livekit.agents import Agent, AgentSession, JobContext, cli, WorkerOptions\nfrom livekit.plugins import aliyun\nfrom dotenv import load_dotenv\n\n\nasync def entry_point(ctx: JobContext):\n \n await ctx.connect()\n \n agent = Agent(instructions=\"You are a helpful assistant.\")\n\n session = AgentSession(\n stt=aliyun.STT(model=\"paraformer-realtime-v2\"),\n tts=aliyun.TTS(model=\"cosyvoice-v2\", voice=\"longcheng_v2\"),\n llm=aliyun.LLM(model=\"qwen-plus\"),\n )\n \n await session.start(agent=agent, room=ctx.room)\n \n await session.generate_reply()\n\nif __name__ == \"__main__\":\n load_dotenv()\n cli.run_app(WorkerOptions(entrypoint_fnc=entry_point))\n```\n\n\u82e5\u9700\u8981\u4f7f\u7528STT\u70ed\u8bcd\u529f\u80fd\uff0c\u9700\u8981\u5728`STT`\u63d2\u4ef6\u4e2d\u914d\u7f6e`vocabulary_id`\u53c2\u6570\u3002\n```python\n session = AgentSession(\n stt=aliyun.STT(model=\"paraformer-realtime-v2\", vocabulary_id=\"your_vocabulary_id\"),\n tts=aliyun.TTS(model=\"cosyvoice-v2\", voice=\"longcheng_v2\"),\n llm=aliyun.LLM(model=\"qwen-plus\"),\n )\n```",
"bugtrack_url": null,
"license": null,
"summary": "LiveKit Agent Plugins for Alibaba Cloud",
"version": "1.2.0",
"project_urls": null,
"split_keywords": [
"audio",
" livekit",
" realtime",
" video",
" webrtc"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "667ca7ff1487c972bca854856de4dc916d79bf54270ba81438ce47f3a82c5703",
"md5": "7d9b15f302b48e936e34e1c687f4105a",
"sha256": "06d0cc729bcb8be27467fe9c24db1bdb9556718d139d53694e4b6a2d0b2662de"
},
"downloads": -1,
"filename": "livekit_plugins_aliyun-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7d9b15f302b48e936e34e1c687f4105a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 13712,
"upload_time": "2025-07-23T02:53:42",
"upload_time_iso_8601": "2025-07-23T02:53:42.384225Z",
"url": "https://files.pythonhosted.org/packages/66/7c/a7ff1487c972bca854856de4dc916d79bf54270ba81438ce47f3a82c5703/livekit_plugins_aliyun-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "98d8cc5bbb3fa241dc9de6bfb6f66c2609c6431bf3654bec8bab3585d81f3931",
"md5": "80aefbede9b2c68719f58f70e84f8bf5",
"sha256": "0f815f5a1ca1f4852a3b7c0e4b223c33c129a589b059d522b7720e06d6582a28"
},
"downloads": -1,
"filename": "livekit_plugins_aliyun-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "80aefbede9b2c68719f58f70e84f8bf5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 11914,
"upload_time": "2025-07-23T02:53:43",
"upload_time_iso_8601": "2025-07-23T02:53:43.729978Z",
"url": "https://files.pythonhosted.org/packages/98/d8/cc5bbb3fa241dc9de6bfb6f66c2609c6431bf3654bec8bab3585d81f3931/livekit_plugins_aliyun-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-23 02:53:43",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "livekit-plugins-aliyun"
}
JSON