spotinst-agent

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 on this page — 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

spotinst-agent on PyPI

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

Evidence: spotinst-agent-1.1.260.tar.gz

Keywords: spotinst, agent, infrastructure, monitoring, execution, deployment

Tags

More Monitoring packages