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

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

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.2.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.2-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: alumnium-0.1.2.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.2.tar.gz
Algorithm Hash digest
SHA256 16f58669db704f56577d9565792bb3b29599e99de3a220553847f1d5c8a9e849
MD5 5a7686ca1a919f33abbc4d4b38a25470
BLAKE2b-256 2711f208f128957d6b33832495b261ab576ac4f7fca836ef59ad064c47b95887

See more details on using hashes here.

Provenance

The following attestation bundles were made for alumnium-0.1.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: alumnium-0.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 dce245763c2d926d2475bdc9ab3897d7b66891176f48c23908a80abcad0a294d
MD5 45f963051eb33417833820fa98373a10
BLAKE2b-256 a5c8631e1923c6bcb7c191b3d4d538ea5ce82077f86b1d152e767565c3e2b265

See more details on using hashes here.

Provenance

The following attestation bundles were made for alumnium-0.1.2-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