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
  • aws_anthropic
  • 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 Nov 22, 2024
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 Nov 22, 2024
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.2.0.tar.gz (13.1 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.2.0-py3-none-any.whl (18.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for alumnium-0.2.0.tar.gz
Algorithm Hash digest
SHA256 e754e5957b569749440ea4928e6ce92122d2a696e941c70b258d5d462c42ac45
MD5 6dae26d7353f2bae88beba51284b346a
BLAKE2b-256 48b5b6cdc0541847755f4ab4461e7ee2eacecc7c0cb7114a96fb57ecb8494aff

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: alumnium-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 18.8 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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ef2a3ff3bbcdb980a85359f4c9a95f5e9c1507456ffc7998bc1a524f68cbd0b6
MD5 11b25a3168b4ca2ea4051756ef7918fa
BLAKE2b-256 f9afaa7d76c7d0716a8d4b96d2ff58fc51b8fc8738201a44836c3058fe650b1f

See more details on using hashes here.

Provenance

The following attestation bundles were made for alumnium-0.2.0-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 Sentry Error logging StatusPage Status page