国产算力友好的 vLLM fork 组织，围绕推理运行时、Ascend 使能、开发工作区、Benchmark、Website 与 AI 应用集成构建完整工程链路。

An upstream-compatible vLLM fork organization focused on domestic-hardware enablement, Ascend support, AGI4S serving, benchmark-driven validation, and a practical multi-repository developer experience.

• Core runtime: vllm-hust
• Ascend plugin: vllm-ascend-hust
• Ascend quantization: vllm-ascend-quant-hust
• Runtime manager: ascend-runtime-manager
• Dev workspace: vllm-hust-dev-hub
• Benchmark wrapper: vllm-hust-benchmark
• Website: vllm-hust-website
• Workstation: vllm-hust-workstation
• Docs: vllm-hust-docs
• Research app: EvoScientist
• Community defaults: .github
• Pages entry: vllm-hust.github.io

vLLM-HUST 以上游 vLLM 生态为基础，重点面向下面几类工作：

• 保持与上游 vLLM / vLLM Ascend 的兼容与可持续同步
• 支持 Ascend 等国产硬件上的推理与部署
• 强化 AGI4S 场景，包括长上下文、工具调用、结构化输出与服务稳定性
• 提供从开发工作区到 Website、Benchmark、Workstation 的完整配套仓库

In practice, the organization concentrates on four goals:

• keep vllm-hust mergeable with upstream vllm whenever possible
• isolate hardware-specific logic in plugins, managers, and deployment tooling
• validate runtime behavior with real benchmarks, smoke tests, and website-facing artifacts
• connect low-level serving infrastructure to end-user and research-facing products

下面的榜单展示 vLLM-HUST 主要仓库里持续推动组织工程演进的核心贡献者，方便新成员快速了解当前的主要维护力量分布。

说明：

• 统计范围：vllm-hust、vllm-ascend-hust、vllm-hust-benchmark、vllm-hust-dev-hub、vllm-hust-docs、vllm-hust-website、vllm-hust-workstation
• fork 去上游：vllm-hust 与 vllm-ascend-hust 仍以官方上游为参照，但统计时优先按主线首父链上的 PR merge 净 diff 归因给 PR 作者；纯同步上游的 merge 与 main2main / upgrade / sync 型提交不计入榜单
• 统计方式：fork 仓库按 PR merge 的净变更量统计，其他仓库按 git log --numstat 聚合；统一指标为 added + deleted；直接提交到主线的 author identity 仍按本仓库 .mailmap 合并
• 展示规则：排除 bot 账号，列出在至少 1 个主要仓库里有提交的全部贡献者
• 快照时间：2026-05-26

flowchart TD
    A[vllm-hust\n核心运行时与 OpenAI 兼容服务]
    B[vllm-ascend-hust\nAscend 硬件插件]
  C[vllm-ascend-quant-hust\nAscend 量化与压缩]
  D[ascend-runtime-manager\nAscend 运行时诊断与修复]
  E[vllm-hust-dev-hub\n多仓开发工作区与 quickstart]
  F[vllm-hust-benchmark\nBenchmark 编排与结果导出]
  G[vllm-hust-website\n官网与 Leaderboard 展示]
  H[vllm-hust-workstation\n本地/私有化 Web 工作台]
  I[vllm-hust-docs\n操作手册与同步记录]
  J[EvoScientist\n面向科研智能体的上层应用]
  K[.github\n组织级社区默认配置]
  L[vllm-hust.github.io\nPages 入口与站点承接]

    B --> A
  C --> B
  D --> A
  E --> A
  E --> B
  E --> D
  F --> A
  F --> G
  H --> A
  I --> A
  I --> B
  J --> A
  K --> A
  K --> B
  K --> F
  K --> H
  L --> G

• vllm-hust 基于上游 vLLM 的主运行时 fork，是整个组织的核心仓库，负责推理引擎、OpenAI 兼容服务、CLI 与主要 CI。

• vllm-ascend-hust vllm-hust 的 Ascend 插件与本地化发行仓库，遵循上游硬件插件模式，尽量把硬件相关逻辑隔离在插件层。

• vllm-ascend-quant-hust 面向 Ascend NPU 的后训练量化仓库，补齐 8-bit、4-bit 与混合精度量化相关能力，服务于模型压缩和部署落地。

• ascend-runtime-manager 独立的 Ascend 运行时修复与诊断工具，负责环境探测、容器化部署、依赖修复与 Python 栈对齐。

• vllm-hust-dev-hub 多仓开发入口，提供 VS Code workspace、quickstart、clone 脚本与自托管 CI 相关工具。

• vllm-hust-docs 组织级文档仓库，用于放置部署手册、兼容性说明、上游同步记录和团队操作指南。

• vllm-hust-benchmark vllm-hust benchmark 的稳定包装层，负责场景编排、结果导出和与 Website 的对接。

• vllm-hust-website 官网、Leaderboard 与演示入口，展示组织介绍、版本信息和 Benchmark 结果快照。

• vllm-hust-workstation 面向终端用户的 Web 工作站，提供统一推理入口、可视化控制台与 EvoScientist 嵌入能力。

• EvoScientist 面向科研工作流的智能体应用，可把 vllm-hust 作为底层推理与工具调用后端。

• .github 组织级 profile 与 community health 仓库，承载公共 issue 模板、PR 模板、安全策略和首页说明文案。

• vllm-hust.github.io GitHub Pages 入口仓库，用于承接组织级页面发布路径和静态站点入口配置。

如果你第一次进入 vLLM-HUST 组织，推荐按这个顺序理解：

1. 从 vllm-hust 开始，理解核心运行时与服务接口。
2. 如果你关注 Ascend 或国产硬件，再看 vllm-ascend-hust 与 ascend-runtime-manager。
3. 如果你要搭本地开发环境，直接使用 vllm-hust-dev-hub。
4. 如果你要做结果展示或性能验证，再看 vllm-hust-benchmark 与 vllm-hust-website。
5. 如果你关注最终用户体验或上层应用，再看 vllm-hust-workstation 与 EvoScientist。

For English-speaking contributors, the same reading order applies:

1. Start with vllm-hust for the runtime and serving surface.
2. Move to vllm-ascend-hust and ascend-runtime-manager for Ascend-specific support.
3. Use vllm-hust-dev-hub for the intended multi-repo development workflow.
4. Read vllm-hust-benchmark and vllm-hust-website for validation and result publication.
5. Finish with vllm-hust-workstation and EvoScientist for user-facing and research-facing applications.

vLLM-HUST 不是从零开始的新推理栈，而是围绕上游项目进行工程化增强：

• 上游运行时参考：vllm-project/vllm
• 上游 Ascend 插件参考：vllm-project/vllm-ascend
• 相关比较与生态参考：sgl-project/sglang

组织内仓库默认优先保持可维护、可同步、可验证，而不是无边界地与上游分叉。

• 想要改运行时或服务链路：从 vllm-hust 开始
• 想要改 Ascend 支持：从 vllm-ascend-hust 和 ascend-runtime-manager 开始
• 想要快速拉起完整开发环境：使用 vllm-hust-dev-hub
• 想要补文档、操作流程、同步记录：前往 vllm-hust-docs

欢迎通过 issue、pull request 和 benchmark / deployment 反馈一起完善这个组织。

This organization also uses this repository for shared community health files:

• default issue templates
• default pull request template
• shared security policy
• shared code of conduct

If a specific repository does not override those files, GitHub will fall back to the defaults provided here.