---
id: spotinst-agent
version: "1.1.260"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# spotinst-agent — Spectrum instance spotinst-agent that is able to run remote scripts, collect data, deploy applications and more.

License: permissive · Maintenance: dormant · Downloads: 313.4K/mo

## What it is and what it does

Spotinst-agent is a polling-based executor that runs on machines to receive and execute remote scripts from the Spotinst platform. It communicates with the Spotinst API using credentials stored in a fixed system location and can be run manually or integrated into infrastructure workflows. The package is distributed as a compiled tarball rather than a standard Python module, and it provides configuration through YAML files for both global framework settings and worker-specific parameters.

The agent is designed for infrastructure automation tasks like deployment, data collection, and lifecycle management on Spotinst-managed instances. It operates in a polling model, checking for work rather than receiving push notifications, and includes options for test runs, verbose logging, and debug modes. However, the project has been dormant for over two years, with no recent commits and only Python 2.7 listed in classifiers, raising questions about compatibility with modern environments.

Use it for:

- Run scheduled shutdown or cleanup scripts on Spotinst-managed instances as part of cost optimization workflows.
- Deploy applications or configuration changes to multiple instances via remote script execution.
- Collect monitoring data or logs from instances and send them back to the Spotinst platform.
- Integrate instance lifecycle events (startup, shutdown) with custom automation scripts.
- Test remote execution logic in non-production environments using the test-run flag.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Spotinst-agent is a remote execution agent that polls for and runs shutdown scripts on machines, requiring API credentials to communicate with the Spotinst platform.

No. The package is dormant (no commits in 782 days), lists only Python 2.7 support, and is distributed as a non-standard tarball requiring manual credential setup. Unless you are already deeply integrated with Spotinst's infrastructure and have verified the agent still works with your Python version and current API, the lack of maintenance and unclear compatibility make this a poor choice for new projects.

## Install

pip install spotinst-agent
uv add spotinst-agent
poetry add spotinst-agent

## Installing spotinst-agent

Before you install: High install friction: the package is distributed as a compiled tarball rather than a standard Python wheel, and maintenance is dormant—no commits recorded since the last release 782 days ago. Requires manual setup of credentials at a fixed system path.

License in practice: MIT license permits commercial and private use with minimal restrictions, requiring only license and copyright notice preservation.

Quickstart:

# Extract the tarball and run the agent
tar -xzf spotinst-agent-1.1.260.tar.gz
cd spotinst-agent
./agent
# Or with options:
./agent -c /path/to/config.yml -l /var/log/agent.log

Credentials file must be located at /root/.spotinst/credentials; agent runs as a binary executable, not a standard Python import.

Verify before relying:

- Whether the agent actually works with modern Python versions, given classifier lists only Python 2.7 support and dormant maintenance status.
- Current state of Spotinst API compatibility and whether the agent's polling architecture remains functional with current platform.
- Whether the tarball distribution includes precompiled binaries or requires local compilation.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: dormant
- Downloads: 313.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

remote script execution agent, spotinst infrastructure automation, machine shutdown orchestration, polling-based deployment agent, spotinst api integration, instance lifecycle management, remote command execution, spotinst-integration, infrastructure-automation, dormant-project

[View on SkillFed](https://skillfed.io/packages/spotinst-agent) · [View on PyPI](https://pypi.org/project/spotinst-agent/)