Alumnium

Pave the way towards AI-powered test automation.

Aluminum is an experimental project that builds upon the existing test automation ecosystem, offering a higher-level abstraction for testing. It aims to simplify interactions with web pages and provide more robust mechanisms for verifying assertions.

Currently in the very early stages of development and not recommended for production use.

Installation

pip install alumnium

Configure AI Provider

Alumnium uses OpenAI by default, but you can change it by following the steps below.

At the moment of writing, Google AI Studio provides free access to its models, so you can use it for playing around with Alumnium.

OpenAI (GPT-4o-mini)

  1. Get the API key from OpenAI.
  2. Give Alumnium access to the API.
export OPENAI_API_KEY="sk-proj-..."

Anthropic (Claude 3 Haiku)

  1. Get the API key from Anthropic.
  2. Tell Alumnium to use Claude and provide access.
export ALUMNIUM_MODEL="anthropic"
export ANTHROPIC_API_KEY="sk-ant-..."

Google (Gemini 1.5 Flash)

  1. Get the API key from Google AI Studio.
  2. Tell Alumnium to use Gemini and provide access.
export ALUMNIUM_MODEL="google"
export GOOGLE_API_KEY="..."

Run Script

Start Alumnium using your Selenium driver and begin interacting with the webpage and check assertions.

from alumnium import Alumni
from selenium.webdriver import Chrome

driver = Chrome()
driver.get("https://google.com")

al = Alumni(driver)
al.do("search for selenium")
al.check("selenium in page title")
al.check("selenium.dev is present in the search results")

Check out more examples!

To Do

  • Cross-browser support (currently only Chrome and Edge are working).
  • Mobile applications support via Appium.
  • Playwright support.
  • Open LLMs support (currently only Anthropic, Google and OpenAI are proven to work).
  • Automatic handling of flakiness.
  • Improved caching for faster performance.
  • High-level multi-step instructions and verifications (currently the instructions must be very concrete).
  • Other languages support (C#, Java, JavaScript, Ruby, etc.)

Environment Variables

ALUMNIUM_DEBUG

Set to 1 to enable debug logs and print them to stdout.

ALUMNIUM_MODEL

Select AI provider to use. Supported values are:

  • anthropic
  • azure_openai
  • google
  • openai

Development

Setup the project:

pipx install poetry
poetry install

Configure access to AI providers:

export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-proj-..."
export GOOGLE_API_KEY="..."

To run REPL for demo, use the following command:

poetry run python -i demo.py

To run Cucumber examples, use the following command:

poetry run behave

To run the Pytest test use the following command:

poetry run pytest

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.21.0)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for p0deje from gravatar.com p0deje Avatar for sh3pik from gravatar.com sh3pik

Credits

Author: Alex Rodionov

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python <4.0, >=3.10

Classifiers

Report project as malware

Download files

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

Source Distribution

alumnium-0.1.3.tar.gz (12.0 kB view details)

Uploaded Source

Built Distribution

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

alumnium-0.1.3-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file alumnium-0.1.3.tar.gz.

File metadata

  • Download URL: alumnium-0.1.3.tar.gz
  • Upload date:
  • Size: 12.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for alumnium-0.1.3.tar.gz
Algorithm Hash digest
SHA256 d65a60b172bf41504824d845f03995ce32f0c4ed3d1b0334d2ffe52fdbf46c59
MD5 4e39812945f339c6172d6f61d765b6a9
BLAKE2b-256 58b4dd4df4f54af2f1c5a23bca977cdd68207380965c91353dabc827a8984e36

See more details on using hashes here.

Provenance

The following attestation bundles were made for alumnium-0.1.3.tar.gz:

Publisher: ci.yml on alumnium-hq/alumnium

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

File details

Details for the file alumnium-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: alumnium-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for alumnium-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 de7df5675ff7d8e2b578188b783b73c0cb53e4bf2a8d0cbcc03db488a56408d5
MD5 b58308c71ddce2e28df1c4ed397495bd
BLAKE2b-256 c8248a0fe15f7cc2c6d4660e4b29eb43d41ff467c62965c5204a752768f7ddba

See more details on using hashes here.

Provenance

The following attestation bundles were made for alumnium-0.1.3-py3-none-any.whl:

Publisher: ci.yml on alumnium-hq/alumnium

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