Files
project_6/upstream_ref/xllm/xllm/cc_api
EX Engine 002f9879b2 ref(upstream): FULL TREE — Deep-Spark xllm (1470) + ds_vllm csrc/models (703)
Replaces cherry-picked upstream_ref with complete source trees.

xllm/ — Iluvatar official C++ inference engine (15MB, 1470 files)
  Complete: kernels → layers → models → runtime → scheduler → api
  Excluded: .git, binary images, third_party submodule checkouts

ds_vllm/ — Iluvatar official vllm fork (8MB, 703 files)
  Included: csrc/ (ALL CUDA kernels), fused_moe/, qwen3_5 model, _custom_ops
  Excluded: tests, benchmarks, docs, examples (not needed for reference)

Critical call chains now fully traceable:
  MoE: moe_topk_softmax_kernels.cuh → ixformer.h → fused_moe.cpp → layer
  GDN: qwen3_gated_delta_net_base.cpp → qwen3_5_gated_delta_net.cpp
  Attention: ixformer.h → xllm_paged_attention → attention.cpp
2026-08-10 02:54:03 +00:00
..

How to compile xllm dynamic library

Run the following command in root directory:

python setup.py build --generate-so true

If you want to debug, it needs to set DEBUG environment variable.

export DEBUG=1

How to install dynamic library

Run installation script xllm/cc_api/install.sh, headers and dynamic library will be installed in /usr/local/xllm directory.

cd xllm/cc_api

sh install.sh

You will see the following files in /usr/local/xllm directory:

[root@A03-R40-I189-101-4100046 cc_api]# tree /usr/local/xllm
/usr/local/xllm
|-- include
|   |-- llm.h
|   |-- macros.h
|   `-- types.h
`-- lib
    |-- libcust_opapi.so
    `-- libxllm.so

3 directories, 5 files

How to run cc_api examples

It provides two examples which use cc_api to create xllm instance and run inference. The single_llm_instance.cpp creates one instance which is used in most LLM scenes. The multiple_llm_instances.cpp creates two instances which is used in multiple-models scene or one model with multiple versions.

You can follow the commands to compile and run these examples:

cd examples && mkdir build
cd build && cmake .. && make && cd ..

sh start-llm-instance.sh