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.0.29a0

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.0.29a0
File Size Uploaded Provenance Actions
xah-0.0.29a0.tar.gz 73.8 kB Without provenance Details for xah-0.0.29a0.tar.gz

Built distribution (wheel)

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

Total release size: 180.7 kB

Release files / xah-0.0.29a0.tar.gz

Download URL xah-0.0.29a0.tar.gz
Size 73.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a2fcfd41845296aeab8302bcd7b4788e4161cae2ce5ca626b75c80450c158bd4
BLAKE2b-256 checksum
How to use checksums
df0ed5119ef7c2fa8e0622aecdfadd70f4032edfb3a7418cc6d21fb8435a14ea
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.0.29a0-py3-none-any.whl

Download URL xah-0.0.29a0-py3-none-any.whl
Size 106.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fdae756ade918181677114dccb45ef96bba5ffa7b027d52c474ec107733bdc5f
BLAKE2b-256 checksum
How to use checksums
f01e54ddae4924f0686d7e84a73b559493967a0f849f62f0de0c51316e7d7a06
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.0.29a0

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