How higress-group/higress works
Higress is a cloud-native AI API gateway built on Istio and Envoy, with Kubernetes Ingress and Gateway API controllers, configurable Wasm extensions, and MCP hosting. The principal workflow is Kubernetes configuration entering the controller, being translated into gateway configuration, and reaching Envoy through xDS; operators can also manage deployments with hgctl. The graph includes documented AI and MCP capabilities alongside sampled controller modules. Some controller wiring and plugin dispatch are documented but not shown in the excerpts, so those links are marked dashed.
Main entry points: server.go xDS server · client.go Kubernetes client · common/controller.go Ingress controller core · gateway/controller.go Gateway API controller
Components 23
Control plane
- Serve command
pkg/cmd/server.go - Server bootstrap
pkg/bootstrap/server.go - xDS server
pkg/bootstrap/server.go - Kubernetes client
pkg/kube/client.go
Kubernetes configuration
- Ingress controller core
pkg/ingress/kube/common/controller.go - Ingress controller
pkg/ingress/kube/ingress/controller.go - Ingress v1 controller
pkg/ingress/kube/ingressv1/controller.go - Gateway API controller
pkg/ingress/kube/gateway/controller.go - Istio Gateway controller
pkg/ingress/kube/gateway/istio/controller.go - KIngress controller
pkg/ingress/kube/kingress/controller.go - ConfigMap controller
pkg/ingress/kube/configmap/controller.go - Wasm plugin controller
pkg/ingress/kube/wasmplugin/controller.go
AI gateway
- AI model proxy
plugins/wasm-go/extensions/ai-proxy/main.go - AI search
plugins/wasm-go/extensions/ai-search/main.go - AI agent
plugins/wasm-go/extensions/ai-agent/main.go - AI extensions
plugins/wasm-go/extensions
MCP hosting
- MCP filter
plugins/golang-filter/main.go - MCP servers
plugins/golang-filter/mcp-server - RAG client
plugins/golang-filter/mcp-server/servers/rag/rag_client.go
Operations
- Deployment manager
hgctl/pkg/installer/installer.go
Other components
- Operator
- Kubernetes resources
- Higress CLI
cmd/higress/main.go
Connections 28
- Operator → Higress CLI: runs
cmd/higress/main.go - Higress CLI → Serve command: executes
cmd/higress/main.go - Serve command → Server bootstrap: starts
pkg/cmd/server.go - Server bootstrap → xDS server: starts
pkg/bootstrap/server.go - Server bootstrap → Kubernetes client: configures
- Kubernetes resources → Kubernetes client: provides resources
- Kubernetes client → Ingress controller: supplies client
- Kubernetes client → Gateway API controller: supplies client
- Kubernetes client → KIngress controller: supplies client
- Kubernetes client → ConfigMap controller: supplies client
- Kubernetes client → Wasm plugin controller: supplies client
pkg/ingress/kube/wasmplugin/controller.go - Ingress controller → Ingress controller core: uses
pkg/ingress/kube/ingress/controller.go - Ingress v1 controller → Ingress controller core: uses
pkg/ingress/kube/ingressv1/controller.go - KIngress controller → Ingress controller core: uses
pkg/ingress/kube/kingress/controller.go - Gateway API controller → Istio Gateway controller: constructs
pkg/ingress/kube/gateway/controller.go - Gateway API controller → Ingress controller core: uses
pkg/ingress/kube/gateway/controller.go - Server bootstrap → Ingress controller core: sets up translation
pkg/bootstrap/server.go - Istio Gateway controller → xDS server: pushes configuration
pkg/ingress/kube/gateway/istio/controller.go - Wasm plugin controller → Kubernetes resources: manages plugins
- xDS server → AI model proxy: dispatches plugins
- xDS server → AI search: dispatches plugins
- xDS server → AI agent: dispatches plugins
- xDS server → AI extensions: dispatches plugins
- xDS server → MCP filter: hosts MCP
- MCP filter → MCP servers: registers servers
plugins/golang-filter/main.go - MCP servers → RAG client: offers retrieval
plugins/golang-filter/mcp-server/servers/rag/rag_client.go - Operator → Deployment manager: manages deployment
- Deployment manager → Kubernetes resources: deploys to