Skip to content

Commit 6213afe

Browse files
authored
Update README.md for 24.06 (#905)
1 parent 2a1ae92 commit 6213afe

File tree

1 file changed

+97
-5
lines changed

1 file changed

+97
-5
lines changed

README.md

Lines changed: 97 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,100 @@ limitations under the License.
1818

1919
# Triton Model Analyzer
2020

21-
> [!Warning]
22-
>
23-
> ##### LATEST RELEASE
24-
>
25-
> You are currently on the `r24.06` branch which tracks under-development progress towards the next release. <br>
21+
Triton Model Analyzer is a CLI tool which can help you find a more optimal configuration, on a given piece of hardware, for single, multiple, ensemble, or BLS models running on a [Triton Inference Server](https://github.com/triton-inference-server/server/). Model Analyzer will also generate reports to help you better understand the trade-offs of the different configurations along with their compute and memory requirements.
22+
<br><br>
23+
24+
# Features
25+
26+
### Search Modes
27+
28+
- [Optuna Search](docs/config_search.md#optuna-search-mode) **_-ALPHA RELEASE-_** allows you to search for every parameter that can be specified in the model configuration, using a hyperparameter optimization framework. Please see the [Optuna](https://optuna.org/) website if you are interested in specific details on how the algorithm functions.
29+
30+
- [Quick Search](docs/config_search.md#quick-search-mode) will **sparsely** search the [Max Batch Size](https://github.com/triton-inference-server/server/blob/r24.06/docs/user_guide/model_configuration.md#maximum-batch-size),
31+
[Dynamic Batching](https://github.com/triton-inference-server/server/blob/r24.06/docs/user_guide/model_configuration.md#dynamic-batcher), and
32+
[Instance Group](https://github.com/triton-inference-server/server/blob/r24.06/docs/user_guide/model_configuration.md#instance-groups) spaces by utilizing a heuristic hill-climbing algorithm to help you quickly find a more optimal configuration
33+
34+
- [Automatic Brute Search](docs/config_search.md#automatic-brute-search) will **exhaustively** search the
35+
[Max Batch Size](https://github.com/triton-inference-server/server/blob/r24.06/docs/user_guide/model_configuration.md#maximum-batch-size),
36+
[Dynamic Batching](https://github.com/triton-inference-server/server/blob/r24.06/docs/user_guide/model_configuration.md#dynamic-batcher), and
37+
[Instance Group](https://github.com/triton-inference-server/server/blob/r24.06/docs/user_guide/model_configuration.md#instance-groups)
38+
parameters of your model configuration
39+
40+
- [Manual Brute Search](docs/config_search.md#manual-brute-search) allows you to create manual sweeps for every parameter that can be specified in the model configuration
41+
42+
### Model Types
43+
44+
- [Ensemble Model Search](docs/config_search.md#ensemble-model-search): Model Analyzer can help you find the optimal
45+
settings when profiling an ensemble model, utilizing the [Quick Search](docs/config_search.md#quick-search-mode) algorithm
46+
47+
- [BLS Model Search](docs/config_search.md#bls-model-search): Model Analyzer can help you find the optimal
48+
settings when profiling a BLS model, utilizing the [Quick Search](docs/config_search.md#quick-search-mode) algorithm
49+
50+
- [Multi-Model Search](docs/config_search.md#multi-model-search-mode): Model Analyzer can help you
51+
find the optimal settings when profiling multiple concurrent models, utilizing the [Quick Search](docs/config_search.md#quick-search-mode) algorithm
52+
53+
- [LLM Search](docs/config_search.md#llm-search-mode): Model Analyzer can help you
54+
find the optimal settings when profiling large language models, utilizing the [Quick Search](docs/config_search.md#quick-search-mode) algorithm
55+
56+
### Other Features
57+
58+
- [Detailed and summary reports](docs/report.md): Model Analyzer is able to generate
59+
summarized and detailed reports that can help you better understand the trade-offs
60+
between different model configurations that can be used for your model.
61+
62+
- [QoS Constraints](docs/config.md#constraint): Constraints can help you
63+
filter out the Model Analyzer results based on your QoS requirements. For
64+
example, you can specify a latency budget to filter out model configurations
65+
that do not satisfy the specified latency threshold.
66+
<br><br>
67+
68+
# Examples and Tutorials
69+
70+
### **Single Model**
71+
72+
See the [Single Model Quick Start](docs/quick_start.md) for a guide on how to use Model Analyzer to profile, analyze and report on a simple PyTorch model.
73+
74+
### **Multi Model**
75+
76+
See the [Multi-model Quick Start](docs/mm_quick_start.md) for a guide on how to use Model Analyzer to profile, analyze and report on two models running concurrently on the same GPU.
77+
78+
### **Ensemble Model**
79+
80+
See the [Ensemble Model Quick Start](docs/ensemble_quick_start.md) for a guide on how to use Model Analyzer to profile, analyze and report on a simple Ensemble model.
81+
82+
### **BLS Model**
83+
84+
See the [BLS Model Quick Start](docs/bls_quick_start.md) for a guide on how to use Model Analyzer to profile, analyze and report on a simple BLS model.
85+
<br><br>
86+
87+
# Documentation
88+
89+
- [Installation](docs/install.md)
90+
- [Model Analyzer CLI](docs/cli.md)
91+
- [Launch Modes](docs/launch_modes.md)
92+
- [Configuring Model Analyzer](docs/config.md)
93+
- [Model Analyzer Metrics](docs/metrics.md)
94+
- [Model Config Search](docs/config_search.md)
95+
- [Checkpointing](docs/checkpoints.md)
96+
- [Model Analyzer Reports](docs/report.md)
97+
- [Deployment with Kubernetes](docs/kubernetes_deploy.md)
98+
<br><br>
99+
100+
# Reporting problems, asking questions
101+
102+
We appreciate any feedback, questions or bug reporting regarding this
103+
project. When help with code is needed, follow the process outlined in
104+
the Stack Overflow (https://stackoverflow.com/help/mcve)
105+
document. Ensure posted examples are:
106+
107+
- minimal – use as little code as possible that still produces the
108+
same problem
109+
110+
- complete – provide all parts needed to reproduce the problem. Check
111+
if you can strip external dependency and still show the problem. The
112+
less time we spend on reproducing problems the more time we have to
113+
fix it
114+
115+
- verifiable – test the code you're about to provide to make sure it
116+
reproduces the problem. Remove all other problems that are not
117+
related to your request/question.

0 commit comments

Comments
 (0)