Skip to main content

alexapy

License Python version compatibility Version on PyPi pipeline status PyPI - Downloads PyPI - Downloads PyPI - Downloads

Python Package for controlling Alexa devices (echo dot, etc) programmatically. This was originally designed for alexa_media_player a custom_component for Home Assistant.

NOTE: Alexa has no official API; therefore, this library may stop working at any time without warning.

Credits

Originally inspired by this blog (GitHub). Additional scaffolding from simplisafe-python

Contributing

  1. Check for open features/bugs or initiate a discussion on one.
  2. Fork the repository.
  3. Install the dev environment: make init.
  4. Enter the virtual environment: pipenv shell
  5. Code your new feature or bug fix.
  6. Write a test that covers your new functionality.
  7. Update README.md with any new documentation.
  8. Run tests and ensure 100% code coverage for your contribution: make coverage
  9. Ensure you have no linting errors: make lint
  10. Ensure you have typed your code correctly: make typing
  11. Add yourself to AUTHORS.md.
  12. Submit a pull request!

License

Apache-2.0. By providing a contribution, you agree the contribution is licensed under Apache-2.0.

API Reference

See the docs 📚.

Smart-home device metadata

await AlexaAPI.get_devices_gql(login) returns the full smart-home endpoint records. Each record can include model (type and value.text/value.locale), dmsIdentifier (deviceType and dsn), and legacyAppliance, including its additionalApplianceDetails JSON value.

Match the DMS device type and serial number to the REST device list's deviceType and serialNumber. Model metadata may be null or sealed; only use PLAIN values as readable descriptions. Amazon can provide descriptions such as Echo Studio (2025 release) or Echo (4th Gen), but does not guarantee a model name or hardware generation for every device. A release year is not a numbered generation. The structure of additionalApplianceDetails is device-dependent.

get_network_details(login) continues to return only legacy appliance records, including additionalApplianceDetails. Call get_devices_gql(login) when the sibling endpoint model and DMS identifier metadata are needed.

Metadata

Release files for AlexaPy 1.36.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for AlexaPy 1.36.0
File Size Uploaded Provenance Actions
alexapy-1.36.0.tar.gz 69.8 kB Without provenance Details for alexapy-1.36.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for AlexaPy 1.36.0
File Interpreter ABI Platform Actions
alexapy-1.36.0-py3-none-any.whl Python 3 none any Details for alexapy-1.36.0-py3-none-any.whl

Total release size: 144.3 kB

Release files / alexapy-1.36.0.tar.gz

Download URL alexapy-1.36.0.tar.gz
Size 69.8 kB
Tags Source
SHA-256 checksum
How to use checksums
aa7f1cfa74f468638af29c8c8261ba58a351a962ce247e093b8eeebb6cbdd28f
BLAKE2b-256 checksum
How to use checksums
72ce5318c35eff188418f1dabe79772c024aef0577c89c07fef45435b5d0cd30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.13.18 Linux/6.12.113+

Release files / alexapy-1.36.0-py3-none-any.whl

Download URL alexapy-1.36.0-py3-none-any.whl
Size 74.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
41c2eac6f521cf10179115e4cbc82b8400c08f898d474c564267be82958e5531
BLAKE2b-256 checksum
How to use checksums
14c971defac0b33f46192efcb2ff4c751aee7001eb826b6e15fb61d3675f26c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.13.18 Linux/6.12.113+

Security for AlexaPy 1.36.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.36.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page