semantic-router

Q: 使用 HybridRouteLayer 报导入错误？

该功能需要额外依赖，先执行 pip install -qU ＂semantic-router[hybrid]＂ 再导入使用。

用语义向量秒级决策，让 AI 路由更聪明。

开源 🏷️定价信息待确认 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 394 🐛 待处理 95 👀 关注 33

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4032

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类对话助手

开发团队aurelio-labs

官网地址https://www.aurelio.ai/semantic-router

GitHubhttps://github.com/aurelio-labs/semantic-router

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,artificial-intelligence,chatbot,computer-vision,generative-ai,machine-learning,nlp

GitHub 星标★ 4032

上线时间2023-10-30 00:00:00

代码更新2026-11-09

仓库体积114.3 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数9

项目介绍

semantic-router 是一个基于语义向量进行快速决策的 Python 库，它利用多模态数据的语义信息来替代传统基于关键词或规则的路由方式。核心解决的是 AI 系统中意图识别和任务分发的问题，通过将用户输入（文本、图像等）编码为向量，并与预定义的语义路由（semantic routes）进行相似度匹配，从而实现高效、准确的决策。其核心能力包括：支持多种向量编码器（如 OpenAI、Hugging Face 等）、动态路由定义、批量处理、以及异步支持。它特别适用于构建对话式 AI 助手、智能客服、内容推荐系统等场景，能够显著提升系统的响应速度和灵活性，减少对硬编码规则的依赖。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4032

技术标签

ai artificial-intelligence chatbot computer-vision generative-ai

使用教程

难度：入门约 5 分钟部署方式：库/依赖 4 步

环境要求

已安装 Python 与 pip 的本地环境
网络可访问 PyPI，以便通过 pip 安装依赖

安装与启动步骤

1安装核心库

README 给出的默认安装方式，用 pip 从 PyPI 安装 semantic-router 核心包，完成后即可导入使用。
```
pip install -qU semantic-router
```
2可选：本地运行扩展

想在完全本地（离线）环境下运行语义路由时使用，配合 HuggingFaceEncoder 与 LlamaCppLLM。
```
pip install -qU "semantic-router[local]"
```
3可选：混合路由扩展

要使用 HybridRouteLayer 时必须安装 hybrid 扩展包，否则该类不可用。
```
pip install -qU "semantic-router[hybrid]"
```
4定义语义路由

在 Python 中导入 Route，用它定义决策路径（README 示例为 politics 与 chitchat 两条简单路由）。
```
from semantic_router import Route
```