Skip to main content

AXL Protocol v3: Compressed semantic protocol for agent reasoning

Project description

AXL Protocol

The universal language for AI agents

75 lines teach any LLM to speak it. 10.41x compression. 100% parse validity. Zero dependencies.

CI PyPI Python License Downloads

Whitepaper · Rosetta · Documentation · Experiments · Website


What is AXL?

AI agents can't talk to each other. They communicate in English prose (50-100 tokens), JSON (even worse), or proprietary formats requiring per-framework SDKs. In a 100-agent network, this produces 22.5 million tokens of negotiation overhead before any productive work happens.

AXL eliminates this. One URL (@axlprotocol.org/rosetta) teaches any agent the complete language on first contact. The protocol has been validated across 11 agents from 10 computational paradigms with 100% parse validity and 95.8% LLM comprehension across four major architectures.

Install

pip install axl-core

Quick Start

Parse a packet:

from axl import parse

packet = parse("π:5:0xSIG:0.001|S:OPS.4|@api.example.com|ERR500|latency|4500ms|500ms|ALERT|URG|LOG")
print(packet.domain)         # "OPS"
print(packet.body.fields)    # ['@api.example.com', 'ERR500', 'latency', '4500ms', '500ms', 'ALERT']
print(packet.flags)          # ['URG', 'LOG']

Emit a packet:

from axl import emit, Packet, Preamble, Body, PaymentProof

packet = Packet(
    preamble=Preamble(payment=PaymentProof(agent_id="5", signature="0xSIG", gas=0.001)),
    body=Body(domain="OPS", tier=4, fields=["@api.example.com", "ERR500", "latency", "4500ms", "500ms", "ALERT"]),
    flags=["URG", "LOG"]
)
print(emit(packet))
# π:5:0xSIG:0.001|S:OPS.4|@api.example.com|ERR500|latency|4500ms|500ms|ALERT|URG|LOG

CLI:

axl parse "π:5:0xSIG:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG"
axl validate "π:5:0xSIG:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG"
axl translate --to english "π:5:0xSIG:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG"

Domains

Domain Purpose Example
OPS Infrastructure & operations Server down, latency spike, disk full
SEC Security & threat detection Theft detected, balance discrepancy
DEV Development & code lifecycle PR merged, build failed, review needed
RES Research & analysis Cross-domain correlation, market analysis
SIG Signal broadcast BTC falling, RSI divergence
COMM Communication & routing Request, ACK, status update
TRD Trading & economic action Short BTC, 2x leverage, 2% max risk
PAY Payment transfer Pay agent $0.02 USDC for crawl task
FUND Funding request Request $5 for infrastructure costs
REG Registration & identity New agent joins the network

The Stack

AXL is the missing language layer in the agent internet:

Layer Protocol Who
Payment x402 Coinbase / Cloudflare
Tool Calling MCP Anthropic
Discovery A2A Google
Social Moltbook Meta
Language AXL AXLPROTOCOL INC

Proven

Two live experiments. Real agents. Real packets. Real results.

Metric Result
Total packets 1,502
Parse validity 100%
Agents tested 11 (10 paradigms)
Domains active 9
LLM comprehension 95.8% (4 models, first read)
Agent-to-agent payments 38
Compression vs English 1.3-3x per message, 71x network

Architecture

  • Parser: parse(string) -> Packet dataclass
  • Emitter: emit(Packet) -> AXL string (round-trip proven)
  • Validator: Schema check, type check, tier range
  • Translator: AXL <-> English <-> JSON
  • CLI: axl parse, axl emit, axl validate, axl translate
  • Zero runtime dependencies

Parser Status

axl-core 0.4.x includes a v1 format parser. Full v3 parser, emitter, validator, and translator ship in 0.5.0. The v3 kernel is included at rosetta/v3.md and live at axlprotocol.org/v3.

Quick v3 parse (positional split):

fields = packet.split("|")
# fields[0]=ID, fields[1]=OP.CC, fields[2]=SUBJ,
# fields[3]=ARG1, fields[4]=ARG2, fields[5]=TEMP

Links

Contributing

See CONTRIBUTING.md for guidelines.

License

Apache 2.0 - AXLPROTOCOL INC · Diego Carranza · 2026

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

axl_core-0.4.1.tar.gz (22.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

axl_core-0.4.1-py3-none-any.whl (20.1 kB view details)

Uploaded Python 3

File details

Details for the file axl_core-0.4.1.tar.gz.

File metadata

  • Download URL: axl_core-0.4.1.tar.gz
  • Upload date:
  • Size: 22.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for axl_core-0.4.1.tar.gz
Algorithm Hash digest
SHA256 56af412c69936753de4b121e5262c12791db1f147b528d89bccbc8b558e44e25
MD5 865dea8ef01441f04989531dd6d85908
BLAKE2b-256 fde36897af9c70a911f851fb9d5039343a89fbec7765660a2504c4b30d3d4388

See more details on using hashes here.

File details

Details for the file axl_core-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: axl_core-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 20.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for axl_core-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a0a7c3ffaa23d3a7fca2e473b33a817bf69295bc44c158a67bfa9220fe806956
MD5 da546067be5321981fba11f003cabe46
BLAKE2b-256 53e8cd5cbd556fb11ec5cd7e2116e4871e45e77bf5387d9665ad856d696fbb55

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page