axon-browser 1.0.0

Python SDK for Axon browser automation

Axon Python SDK

A Python client library for Axon browser automation.

Installation

pip install axon-browser

Quick Start

import asyncio
from axon import Axon

async def main():
    async with Axon("http://localhost:8020/api/v1") as axon:
        # Create a session
        session = await axon.create_session("mysession")
        print(f"Created session: {session.session_id}")
        
        # Navigate to a URL
        await axon.navigate("mysession", "https://github.com")
        
        # Get snapshot
        snapshot = await axon.snapshot("mysession")
        print(f"Page title: {snapshot.title}")
        
        # Click an element
        result = await axon.click("mysession", "e1")
        print(f"Action result: {result.success}")

asyncio.run(main())

Configuration

The Axon client can be configured via:

1. Constructor parameter:

   axon = Axon("http://localhost:8020/api/v1")
   

2. Environment variable:

   export AXON_API_URL=http://localhost:8020/api/v1
   

   axon = Axon()  # Uses AXON_API_URL env var
   

API Reference

Session Management

# Create a session
session = await axon.create_session("mysession")

# Get session info
info = await axon.get_session("mysession")

# List all sessions
sessions = await axon.list_sessions()

# Delete a session
await axon.delete_session("mysession")

Navigation

# Navigate to a URL
await axon.navigate("mysession", "https://github.com")

Snapshots

# Get page snapshot
snapshot = await axon.snapshot("mysession")

# Print page elements
for element in snapshot.elements:
    print(f"{element.role}: {element.name}")

Actions

# Click
await axon.click("mysession", "e1")

# Fill input
await axon.fill("mysession", "e2", "Hello World")

# Hover
await axon.hover("mysession", "e3")

# Select option
await axon.select("mysession", "e4", "option1")

# Generic action
await axon.act("mysession", "click", "e1")

Find and Act

# Find element by semantic description and perform action
result = await axon.find_and_act(
    "mysession", 
    "click", 
    "search button"
)

Development

# Clone the repository
git clone https://github.com/rennissance-jomt/axon
cd axon/python

# Install in development mode
pip install -e .

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check .