aibrix icon indicating copy to clipboard operation
aibrix copied to clipboard

[Integration]: Add Intelligent Semantic Routing with vLLM-SR

Open Xunzhuo opened this issue 1 month ago • 10 comments

Pull Request Description

[Integration]: Add Intelligent Semantic Routing with vLLM-SR


Contribution Guidelines (Expand for Details)

We appreciate your contribution to aibrix! To ensure a smooth review process and maintain high code quality, please adhere to the following guidelines:

Pull Request Title Format

Your PR title should start with one of these prefixes to indicate the nature of the change:

  • [Bug]: Corrections to existing functionality
  • [CI]: Changes to build process or CI pipeline
  • [Docs]: Updates or additions to documentation
  • [API]: Modifications to aibrix's API or interface
  • [CLI]: Changes or additions to the Command Line Interface
  • [Misc]: For changes not covered above (use sparingly)

Note: For changes spanning multiple categories, use multiple prefixes in order of importance.

Submission Checklist

  • [ ] PR title includes appropriate prefix(es)
  • [ ] Changes are clearly explained in the PR description
  • [ ] New and existing tests pass successfully
  • [ ] Code adheres to project style and best practices
  • [ ] Documentation updated to reflect changes (if applicable)
  • [ ] Thorough testing completed, no regressions introduced

By submitting this PR, you confirm that you've read these guidelines and your changes align with the project's contribution standards.

Xunzhuo avatar Nov 06 '25 07:11 Xunzhuo

Summary of Changes

Hello @Xunzhuo, I'm Gemini Code Assist[^1]! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces extensive documentation for integrating Intelligent Semantic Routing (vLLM-SR) with AIBrix. The new guide explains how vLLM-SR enhances LLM inference by intelligently routing requests to the most suitable backend models, improving scalability, and optimizing costs. It provides clear instructions for deploying and testing this integration, ensuring users can easily leverage its advanced capabilities.

Highlights

  • New Feature Documentation: Introduced comprehensive documentation for integrating Intelligent Semantic Routing with vLLM-SR into the AIBrix ecosystem.
  • Deployment and Testing Guide: Added detailed, step-by-step instructions for deploying the vLLM Semantic Router, a demo LLM, and necessary Gateway API resources, along with methods for testing the deployment locally.
  • Semantic Router Capabilities: Outlined the key features of vLLM Semantic Router, including intelligent routing, AI-powered security, semantic caching, auto-reasoning, real-time analytics, and a scalable architecture.
  • Integration Benefits: Detailed the advantages of integrating vLLM Semantic Router with AIBrix, such as intelligent request routing, enhanced scalability, cost optimization, production-ready infrastructure, and simplified operations.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with :thumbsup: and :thumbsdown: on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

[^1]: Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

gemini-code-assist[bot] avatar Nov 06 '25 07:11 gemini-code-assist[bot]

Tested OK :heavy_check_mark:

Hi, I have created aibrix cluster following guide -- https://github.com/vllm-project/aibrix/blob/main/development/vllm/README.md ; after that I followed this PR guide to add semantic-router. It's working as expected.

Thanks @Xunzhuo :+1:

nurali-techie avatar Nov 07 '25 11:11 nurali-techie

thanks for testing it @nurali-techie

Xunzhuo avatar Nov 07 '25 12:11 Xunzhuo

I think the initial version overall looks good to me. I would like to check whether that's helpful to make it part of the release manifest. @googs1025 @Xunzhuo @nurali-techie any ideas?

Jeffwan avatar Nov 08 '25 22:11 Jeffwan

I think the initial version overall looks good to me. I would like to check whether that's helpful to make it part of the release manifest. @googs1025 @Xunzhuo @nurali-techie any ideas?

Integration would be ideal and great! Currently, semantic-router release doesn't seem to have been officially released yet, so we can put integration into the Helm chart or manifest to the next step (perhaps until semantic-router is officially released). For now, we can let users try it out through docs. 😄

googs1025 avatar Nov 09 '25 02:11 googs1025

I think the initial version overall looks good to me. I would like to check whether that's helpful to make it part of the release manifest. @googs1025 @Xunzhuo @nurali-techie any ideas?

@Jeffwan If this PR is part of v0.5.0 release then it's better to mention about semantic-router in release manifest. If need be then we can add "experimental" word, to indicate user that you can "try out" semantic-router with this release and expect more to come in sub-sequent release.

nurali-techie avatar Nov 09 '25 02:11 nurali-techie

sounds good. v0.5.0 has been cut. We can put it in v0.6.0. Consider @googs1025 has another PR on ai gateway integration. I think it's time to revisit the gateway arch now. I will follow up in slack channel

Jeffwan avatar Nov 11 '25 00:11 Jeffwan

I think it's time to revisit the gateway arch now. I will follow up in slack channel

@Jeffwan true :+1: I am interested to get involved here. Plz tag me in the future discussion whenever possible :pray:

nurali-techie avatar Nov 12 '25 13:11 nurali-techie

@Xunzhuo did you get a chance to address the comments? I think there're few issues need to be fixed

Jeffwan avatar Nov 14 '25 22:11 Jeffwan

@Xunzhuo any updates? /cc @googs1025

Jeffwan avatar Nov 27 '25 07:11 Jeffwan