Strategy Advisor plugin for az-scout — capacity deployment strategy recommendations
Project description
az-scout-plugin-strategy-advisor
⚠️ Work in Progress — This plugin is under active development. APIs, models, and behaviors may change without notice. It is not recommended for production use at this time.
Strategy Advisor plugin for az-scout — capacity deployment strategy recommendations.
Features
- UI tab — Strategy Advisor form with subscription picker, workload constraints, and results rendering
- API route —
POST /plugins/strategy/capacity-strategyto compute deployment strategies - MCP tool —
capacity_strategytool for AI agents to obtain deployment recommendations - Strategy engine — Evaluates (region, SKU) combinations against zones, quotas, restrictions, spot scores, pricing, confidence, and inter-region latency
Strategies
The engine recommends one of: single_region, active_active, active_passive, sharded_multi_region, burst_overflow, time_window_deploy, progressive_ramp.
Setup
# Install alongside az-scout
uv pip install -e .
# The plugin is auto-discovered at startup
az-scout
Structure
src/az_scout_strategy/
├── __init__.py # Plugin class + module-level `plugin` instance
├── engine.py # Capacity strategy computation engine
├── models.py # Pydantic models (request/response)
├── routes.py # FastAPI APIRouter (POST /capacity-strategy)
├── tools.py # MCP tool function
└── static/
├── html/
│ └── strategy-tab.html # HTML fragment (fetched by JS at runtime)
└── js/
└── strategy-tab.js # Tab UI logic
Dependencies
This plugin depends on the following az-scout core modules:
az_scout.azure_api— ARM API calls (SKUs, quotas, spot scores, prices)az_scout.scoring.deployment_confidence— Confidence scoringaz_scout.services._evaluation_helpers— Shared evaluation utilitiesaz_scout.services.region_latency— Inter-region latency data
Quality checks
uv run ruff check src/ tests/
uv run ruff format --check src/ tests/
uv run mypy src/
uv run pytest
Versioning
Uses CalVer (YYYY.MM.MICRO) via hatch-vcs. Tag and push to release:
git tag v2026.2.0
git push origin v2026.2.0
License
Disclaimer
This tool is not affiliated with Microsoft. All capacity, pricing, and latency information are indicative and not a guarantee of deployment success. Spot placement scores are probabilistic. Quota values and pricing are dynamic and may change between planning and actual deployment. Latency values are based on Microsoft published statistics and must be validated with in-tenant measurements.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file az_scout_plugin_strategy_advisor-2026.2.1.tar.gz.
File metadata
- Download URL: az_scout_plugin_strategy_advisor-2026.2.1.tar.gz
- Upload date:
- Size: 126.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
97c43f273a6ff80921074e983c56853ae0a4897417632d7b7afbd9c4f8ea94aa
|
|
| MD5 |
7b79689e4582e086644175978416f76e
|
|
| BLAKE2b-256 |
38e452d209c7522974eb1547dcfd98fd63c969fa3855b6a2bf63eff9d40c7573
|
Provenance
The following attestation bundles were made for az_scout_plugin_strategy_advisor-2026.2.1.tar.gz:
Publisher:
publish.yml on lrivallain/az-scout-plugin-strategy-advisor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
az_scout_plugin_strategy_advisor-2026.2.1.tar.gz -
Subject digest:
97c43f273a6ff80921074e983c56853ae0a4897417632d7b7afbd9c4f8ea94aa - Sigstore transparency entry: 1005367444
- Sigstore integration time:
-
Permalink:
lrivallain/az-scout-plugin-strategy-advisor@1afe8fa43a9da026a2f2f2a2b282dd340369d5aa -
Branch / Tag:
refs/tags/v2026.2.1 - Owner: https://github.com/lrivallain
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1afe8fa43a9da026a2f2f2a2b282dd340369d5aa -
Trigger Event:
push
-
Statement type:
File details
Details for the file az_scout_plugin_strategy_advisor-2026.2.1-py3-none-any.whl.
File metadata
- Download URL: az_scout_plugin_strategy_advisor-2026.2.1-py3-none-any.whl
- Upload date:
- Size: 21.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be851d9cc41d0dd704a3ddeccf195157ec237da8aaf0c1622480086762cc9956
|
|
| MD5 |
bd94607cf4af598a2606ce1879ee643c
|
|
| BLAKE2b-256 |
37f90a03307d12e0045e28852ff6251b2be47e68579e679302a22419a9d03090
|
Provenance
The following attestation bundles were made for az_scout_plugin_strategy_advisor-2026.2.1-py3-none-any.whl:
Publisher:
publish.yml on lrivallain/az-scout-plugin-strategy-advisor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
az_scout_plugin_strategy_advisor-2026.2.1-py3-none-any.whl -
Subject digest:
be851d9cc41d0dd704a3ddeccf195157ec237da8aaf0c1622480086762cc9956 - Sigstore transparency entry: 1005367446
- Sigstore integration time:
-
Permalink:
lrivallain/az-scout-plugin-strategy-advisor@1afe8fa43a9da026a2f2f2a2b282dd340369d5aa -
Branch / Tag:
refs/tags/v2026.2.1 - Owner: https://github.com/lrivallain
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1afe8fa43a9da026a2f2f2a2b282dd340369d5aa -
Trigger Event:
push
-
Statement type: