Skip to content

InferSight

The open-source intelligence layer for AI inference infrastructure.

🚧 Early Development β€” Architecture complete, implementation underway.

License Python PRs Welcome


Serving tells you what is running. InferSight tells you why it is slow and how to improve it.

InferSight collects telemetry from LLM inference systems, identifies performance bottlenecks, recommends optimizations, validates deployment configurations, and provides an AI copilot for troubleshooting.

InferSight does not serve models β€” it helps teams operate inference systems efficiently.


The Pipeline

  Collect        Analyze        Recommend       Validate        Explain
     β”‚              β”‚               β”‚               β”‚              β”‚
     β–Ό              β–Ό               β–Ό               β–Ό              β–Ό
vLLM/SGLang   Detect issues   Ranked config   K8s/Helm/TF/   AI Copilot
TGI/Triton    with evidence   changes with    Ray static     grounded in
KServe/Ray    & thresholds    impact ranges   analysis       inference
                                                             telemetry

Example

$ infersight analyze --engine vllm --endpoint localhost:8000
Health Score: 81/100

Issues Detected
  ⚠  GPU utilization:   38%   (threshold: 60%)
  ⚠  KV cache hit rate: 14%   (prefix caching disabled)

Recommendations  (ranked by estimated impact)
  1. Enable prefix caching           --enable-prefix-caching
  2. Increase max_num_batched_tokens  --max-num-batched-tokens 4096
  3. Tune scheduler policy           --scheduling-policy fcfs

Estimated Improvement
  TTFT        -24%
  Throughput  +18%
  Cost        -11%

Dashboard

🚧 Screenshot coming soon β€” dashboard implementation is in progress.


Who Is This For?

  • ML Platform Engineers managing inference fleets at scale
  • AI Infrastructure Teams deploying LLMs in production
  • MLOps Engineers optimizing cost and latency
  • Kubernetes Operators running GPU workloads
  • GPU Cluster Operators maximizing hardware utilization

Features

Phase Capability Status
πŸ“Š Observability Unified metrics from 7 engines; Prometheus & Grafana export ⏳ Planned
πŸ” Analysis 7 automated issue detectors with configurable thresholds ⏳ Planned
πŸ’‘ Recommendations Ranked guidance with impact estimates & engine-native config snippets ⏳ Planned
πŸ—οΈ Infra Advisor Static analysis of K8s, Helm, Terraform, Ray configs β€” CI/CD ready ⏳ Planned
πŸ€– AI Copilot Conversational troubleshooting grounded in inference telemetry and operational context ⏳ Planned

Full requirements β†’


Development Status

Component Status
Specification βœ… Complete
Architecture βœ… Complete
Plugin Framework ⏳ Planned
vLLM Collector ⏳ Planned
SGLang Collector ⏳ Planned
Analyzer Engine (7 detectors) ⏳ Planned
Recommendation Engine ⏳ Planned
Infrastructure Advisor ⏳ Planned
React Dashboard ⏳ Planned
AI Copilot ⏳ Planned

InferSight is in active development. The spec and architecture are complete; implementation begins with Phase 0 scaffolding. See tasks.md for the full implementation plan.


Supported Engines

Engine Status
vLLM ⏳ Planned
SGLang ⏳ Planned
HuggingFace TGI ⏳ Planned
NVIDIA Triton ⏳ Planned
KServe ⏳ Planned
Amazon SageMaker HyperPod ⏳ Planned
Ray Serve ⏳ Planned

Want to add an engine? Write a collector plugin β†’


Architecture

               Inference Engine Fleet
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚  vLLM  β”‚ SGLang  β”‚ TGI  β”‚ Triton β”‚ KServe β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                          β”‚
                  Collector Plugins
                  (pull or push)
                          β”‚
                          β–Ό
                 Canonical Metric Schema
                          β”‚
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β–Ό                       β–Ό
        Analyzer Engine         Infra Advisor
        (7 detectors)           (K8s/Helm/TF/Ray)
              β”‚
              β–Ό
       Recommendation Engine
       (ranked by estimated impact)
              β”‚
     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
     β–Ό                       β–Ό
  Storage              Notification Engine
  (SQLite /            (issues + recommendations)
  Prometheus/                  β”‚
  InfluxDB)            β”Œβ”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”
     β”‚                 β–Ό               β–Ό
     β–Ό               Slack         PagerDuty
  REST API +                        Email
  WebSocket
     β”‚
  β”Œβ”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β–Ό                       β–Ό
Dashboard             AI Copilot
(React 18)            (LiteLLM)

Full design doc β†’


Quick Start

InferSight is not yet installable β€” implementation is in progress. The steps below reflect the intended UX once Phase 1 ships.

pip install infersight
# infersight.yaml
server:
  port: 8000

deployments:
  - id: my-vllm
    engine: vllm
    endpoint: http://localhost:8000
infersight serve --config infersight.yaml
# Dashboard: http://localhost:8000
# API docs:  http://localhost:8000/docs

Future Integrations

Community contributions welcome:

  • llama.cpp
  • TensorRT-LLM
  • OpenShift AI
  • Amazon EKS managed auth
  • Google Kubernetes Engine (GKE)
  • Vertex AI
  • Azure Machine Learning

Documentation

Document Description
Requirements Product requirements with acceptance criteria
Design Architecture, schemas, plugin ABCs, API reference
Tasks 76-task implementation plan across 12 phases
Roadmap Phase timeline and community wishlist
Contributing How to contribute code, plugins, and docs
Changelog Release history

Contributing

InferSight is built to be extended. The plugin architecture makes it straightforward to add new inference engine collectors, custom analyzers, and recommendation logic without touching core code.

See CONTRIBUTING.md to get started.


License

Apache 2.0 β€” see LICENSE.


Built for the ML infrastructure community. Inspired by the operational challenges of running LLMs at scale.

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages