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.0a2

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.0a2
File Size Uploaded Provenance Actions
xah-0.1.0a2.tar.gz 73.9 kB Without provenance Details for xah-0.1.0a2.tar.gz

Built distribution (wheel)

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

Total release size: 180.8 kB

Release files / xah-0.1.0a2.tar.gz

Download URL xah-0.1.0a2.tar.gz
Size 73.9 kB
Tags Source
SHA-256 checksum
How to use checksums
af0bbda046a725f28552116035324e4b1713b0bdb2939d75eb01588d47e9c66f
BLAKE2b-256 checksum
How to use checksums
aed0eb96d26e4442dac328de7f55a4e3d57ad2ef60b45addd004c8e13de308c1
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.0a2-py3-none-any.whl

Download URL xah-0.1.0a2-py3-none-any.whl
Size 106.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6a07580c4c1bcf6f8eb89f49c113115e28be8d794d40834511ec49f59559f796
BLAKE2b-256 checksum
How to use checksums
3bb55dda2d61a162542e8b2d535ace88fd6b4f743660692e1ca940bf352e092c
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.0a2

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