---
id: axiom-py
version: "0.12.0"
license: MIT License Copyright (c) 2021 Axiom, Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# axiom-py — Official bindings for the Axiom API

License: permissive · Maintenance: active · Downloads: 875.6K/mo

## What it is and what it does

axiom-py is the official Python client for Axiom, a serverless analytics platform. It lets you ingest structured events into named datasets and query them using Axiom's query language, with built-in support for both blocking and async workflows. The library wraps HTTP calls to Axiom's API via httpx and requests, handling serialization through ujson and dacite for type conversion.

The package supports regional edge endpoints for improved data locality during ingest and query, and includes a dedicated client method for Metrics Processing Language (MPL) queries on OpenTelemetry metrics. Both sync and async clients are provided; the async variant enables concurrent operations like ingesting to multiple datasets in parallel. It targets Python 3.8+ and is actively maintained.

Use it for:

- Ingest application logs and events into Axiom datasets from a Python service or script.
- Query stored events and metrics programmatically to build dashboards or alerts.
- Use regional edge endpoints to reduce latency for high-volume event ingestion in distributed systems.
- Run concurrent ingest operations to multiple datasets using the async client.
- Query OpenTelemetry metrics using MPL from Python applications.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

axiom-py provides a Python client for ingesting events and querying data in Axiom, with support for both synchronous and asynchronous operations, regional edge endpoints, and metrics queries using MPL.

Yes. axiom-py is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. Install it if you are building on Axiom's platform and need a Python client for event ingestion and querying. The async support and edge endpoint configuration make it suitable for production observability pipelines.

## Install

pip install axiom-py
uv add axiom-py
poetry add axiom-py

## Installing axiom-py

Before you install: Low friction install with a pure-Python wheel and active maintenance—last release 88 days ago with no known vulnerabilities. Depends on common HTTP and serialization libraries (httpx, requests, ujson, dacite, pyhumps, iso8601, requests-toolbelt).

License in practice: MIT License permits unrestricted use, modification, and distribution with minimal restrictions—suitable for commercial and open-source projects.

Quickstart:

pip install axiom-py

import axiom_py

client = axiom_py.Client()
client.ingest_events(dataset="DATASET_NAME", events=[{"foo": "bar"}])
result = client.query(r"['DATASET_NAME'] | where foo == 'bar' | limit 100")

Requires an Axiom API token (xaat- prefix for edge endpoints, or personal token for main API) set via environment variable or passed to Client().

Verify before relying:

- Whether the async client's concurrent operations scale efficiently under high load or have rate-limiting constraints.
- Performance characteristics of edge endpoint routing for ingest vs. query workloads.
- Backward compatibility guarantees after the v0.9.0 aggregation enum removal mentioned in the warning.

## Package facts

- License: MIT License Copyright (c) 2021 Axiom, Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 875.6K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

axiom api client python, event ingestion and querying, observability data client, async http client for logs, regional edge endpoints, metrics query language, time-series data ingestion, observability, async-http, analytics-client

[View on SkillFed](https://skillfed.io/packages/axiom-py) · [View on PyPI](https://pypi.org/project/axiom-py/)