Skip to main content

AXL Protocol v3: Compressed semantic protocol for agent reasoning. Deterministic English-to-AXL compression.

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

v3 Support

Full v3 parser, emitter, validator, and translator included. Auto-detects v1 vs v3 format. All v1 code preserved for backward compatibility.

from axl import parse_v3, emit_v3, validate_v3, v3_to_json, v3_to_english

pkt = parse_v3("ID:MKT-01|OBS.99|$BTC|^67420|^fund:-0.02%+^OI:12.4B|NOW")
print(pkt.operation)      # Operation.OBS
print(pkt.confidence)     # 99
print(pkt.subject_value)  # BTC

print(emit_v3(pkt))       # ID:MKT-01|OBS.99|$BTC|^67420|^fund:-0.02%+^OI:12.4B|NOW
print(v3_to_english(pkt)) # MKT-01 observes $BTC at ^67420 with 99% confidence.
print(v3_to_json(pkt))    # {"v":"3","id":"MKT-01","op":"OBS","cc":99,...}
print(validate_v3(pkt))   # [] (no errors)

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.6.1.tar.gz (32.4 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.6.1-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: axl_core-0.6.1.tar.gz
  • Upload date:
  • Size: 32.4 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.6.1.tar.gz
Algorithm Hash digest
SHA256 6f6a28a340ced87b6635f3f920d6cecf858c9e982431cfa8a6a70d44a470b92d
MD5 71dd7549aabec331cf4ff90b8b39103c
BLAKE2b-256 6c51f5bf9c00d3545d141dd3bd3f815fd5ae3042589697d92ef326106807401a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: axl_core-0.6.1-py3-none-any.whl
  • Upload date:
  • Size: 29.4 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.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f1055caeb4561fa2b49b149ca69cc07547d6daf4957648ca0c7ce3e7f54c7e4d
MD5 fa81e5fd717068971c34b782162efdfb
BLAKE2b-256 cf1f438d4abc64a14dcbc9cf0414198e11475950624dc26ba434a2e3c75e3248

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