Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

xah

What does it stand for?

eXtensible Agent Harness—or perhaps “Not Another Harness!”

How is it pronounced?

The a is silent.

Should I use xah?

xah is for people comfortable with Python development—directly or via agents—who want fine-grained control over how their agents behave.

Who might find it useful?

xah may be useful if you want to:

  • Work with locally hosted models, whose tool discipline may not always be reliable.
  • Add custom tools—for example, ensure the agent can only run the right version of Python.
  • Add validation that blocks misbehavior even when prompts asking the agent not to do something have failed.
  • Add tools that aren't typically available in existing harnesses.
  • Subclass or extend existing tools, validation workflows, or subagents.
  • Extend agents to non-coding workflows.

Who is xah not for?

  • If you use frontier models exclusively and they already behave roughly how you want, a mainstream off-the-shelf agent may be a better fit.
  • If you do not want to work in Python or maintain code-level customizations, xah's main strength—extending the harness in Python—may not be useful to you.

Why does xah exist?

There are two main motivations for xah: extensibility, and adapting ACP for agents beyond coding.

Extensibility

Existing harnesses can be limiting when a developer—or an agent working with them—needs to develop tools in a fine-grained, debuggable way. Common approaches tend to fall into a few groups:

  • Instructions: add more context in files such as AGENTS.md or skills, then hope the agent follows it.
  • Configuration: set coarse-grained options for behavior and permissions.
  • Plugin systems: gain more power, but learn a separate workflow; plugins can also be difficult to debug when they run through the agent.

These approaches have their place, but they aren't a substitute for being able to change the harness directly. xah makes it straightforward to develop and debug custom tools and validation as Python code. A prompt can ask an agent not to misbehave; code can block it from doing so.

xah is built on Pydantic AI and Pydantic Deep Agents.

Adapting ACP for non-coding agents

The Agent Client Protocol (ACP) is designed to connect coding agents with clients such as editors and IDEs. It provides a standard communication interface, rather than a bespoke integration for every agent and client. ACP is not an agent-to-agent coordination protocol.

xah begins with the familiar coding-agent use case—an IDE, terminal UI, or similar client—and explores using that client experience with agents for other kinds of work, too.

Get started

Install xah from PyPI and start the server:

pip install xah
xah

For an ephemeral run, use uvx xah. The server needs an ACP client for the interactive interface. See the quick start and PyCharm or Zed setup instructions, then work through the tutorials to extend xah.

Model adapters

Declare adapter classes in a harness's Models method; xah constructs each adapter with the harness's complete settings object. Adapters can use that object for provider credentials while keeping Pydantic AI model settings separate. The ai.token setting is a SecretStr; standalone xah reads it from XAH__AI__TOKEN.

Built-in toolsets

xah ships with built-in toolsets for common agent capabilities. See the built-in toolsets reference for the catalogue and short descriptions.

Documentation

Visit the xah documentation for setup, ACP client configuration, tutorials, and agent data and skills.

Metadata

Release files for xah 0.1.0a12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xah 0.1.0a12
File Size Uploaded Provenance Actions
xah-0.1.0a12.tar.gz 76.8 kB Without provenance Details for xah-0.1.0a12.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for xah 0.1.0a12
File Interpreter ABI Platform Actions
xah-0.1.0a12-py3-none-any.whl Python 3 none any Details for xah-0.1.0a12-py3-none-any.whl

Total release size: 187.5 kB

Release files / xah-0.1.0a12.tar.gz

Download URL xah-0.1.0a12.tar.gz
Size 76.8 kB
Tags Source
SHA-256 checksum
How to use checksums
748dc0117663981687d8e9c48fe23d6442ee4bf3902e0626c0d9c205e3bea559
BLAKE2b-256 checksum
How to use checksums
dde2e853a1191c1a864922586bcf611858d573a625f3f39682fd1155384a218a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / xah-0.1.0a12-py3-none-any.whl

Download URL xah-0.1.0a12-py3-none-any.whl
Size 110.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bf7420312de95493e2a24009777a5ce721c8ffce195c05cfac1c56d2b512bc79
BLAKE2b-256 checksum
How to use checksums
183a4fd498419a53616a233b1593674f8f7c93744cf3ea10922c31db3630a68a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for xah 0.1.0a12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page