Skip to main content

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 routePOST /plugins/strategy/capacity-strategy to compute deployment strategies
  • MCP toolcapacity_strategy tool 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 scoring
  • az_scout.services._evaluation_helpers — Shared evaluation utilities
  • az_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

MIT

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

az_scout_plugin_strategy_advisor-2026.2.1.tar.gz (126.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file az_scout_plugin_strategy_advisor-2026.2.1.tar.gz.

File metadata

File hashes

Hashes for az_scout_plugin_strategy_advisor-2026.2.1.tar.gz
Algorithm Hash digest
SHA256 97c43f273a6ff80921074e983c56853ae0a4897417632d7b7afbd9c4f8ea94aa
MD5 7b79689e4582e086644175978416f76e
BLAKE2b-256 38e452d209c7522974eb1547dcfd98fd63c969fa3855b6a2bf63eff9d40c7573

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file az_scout_plugin_strategy_advisor-2026.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for az_scout_plugin_strategy_advisor-2026.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 be851d9cc41d0dd704a3ddeccf195157ec237da8aaf0c1622480086762cc9956
MD5 bd94607cf4af598a2606ce1879ee643c
BLAKE2b-256 37f90a03307d12e0045e28852ff6251b2be47e68579e679302a22419a9d03090

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page