awsiot (CLI Utility for IoT Provisioning)

0.1.3 · abandoned · verified Thu Apr 16

awsiot is an abandoned command-line utility designed to easily provision IoT things in AWS. Last updated in 2017 at version 0.1.3 (Alpha status), it is no longer actively maintained. For current AWS IoT development in Python, users should refer to the official and actively supported AWS IoT Device SDK for Python v2 (`awsiotsdk`) or the older v1 SDK (`AWSIoTPythonSDK`).

Common errors

```
command not found: awsiot
```
cause The `awsiot` command-line utility is either not installed or its installation directory is not in your system's PATH.

fix Ensure the library is installed with `pip install awsiot`. If using a virtual environment, activate it. Check your system's PATH environment variable.
```
No module named 'awsiot'
```
cause This error often occurs when attempting to `import awsiot` in a Python script, or when `awsiotsdk` (the official SDK) was installed instead of `awsiot`.

fix The `awsiot` library is primarily a command-line utility, not intended for direct programmatic import by end-users. If you need a Python SDK, install `awsiotsdk` (`pip install awsiotsdk`) and import its specific modules (e.g., `from awsiot import mqtt`). If you intended to use the `awsiot` CLI, ensure it's installed and callable from the command line.
```
TypeError: 'module' object is not callable
```
cause This can happen when trying to run `awsiot` as a Python script directly (e.g., `python -m awsiot`) instead of as a command-line tool, or when calling a non-existent function.

fix Use `awsiot <command> [options]` directly from your terminal. If you are trying to use programmatic features, be aware that this library is not designed for that, and you should use `awsiotsdk`.

Warnings

breaking This library is designed for Python 3.3-3.6. It is highly likely to be incompatible with newer Python versions (3.7+), and almost certainly broken on Python 3.12+ due to the removal of `ssl.wrap_socket` which affected older AWS SDKs.
Fix: Use the official AWS IoT Device SDK for Python v2 (`awsiotsdk`) which supports modern Python versions.
deprecated The `awsiot` library is an abandoned project last updated in 2017. It is not maintained and should not be used for new development. Official AWS IoT SDKs provide robust and actively supported alternatives.
Fix: Migrate to `awsiotsdk` (AWS IoT Device SDK for Python v2) for all AWS IoT interactions.
gotcha There are several Python libraries for AWS IoT, including `awsiotsdk` (v2), `AWSIoTPythonSDK` (v1), and this `awsiot` CLI utility. Users frequently confuse them, leading to incorrect installations and import errors.
Fix: Always verify the exact package name (`pip install ...`) and the expected import path or command-line invocation. For current development, use `awsiotsdk`.

Install

pip install awsiot Install awsiot CLI

Quickstart

awsiot is primarily used via the command line for provisioning tasks. Ensure your AWS credentials are configured (e.g., via environment variables or AWS CLI) before running commands.

# This is a command-line utility, not typically imported in Python scripts.
# Example command to create an IoT thing (requires AWS credentials configured):
# awsiot create --name my-new-iot-thing --template '{"thingTypeName":"myThingType"}'

# To view help:
# awsiot --help

view raw JSON →