{"info":{"author":null,"author_email":"Diego Carranza ","bugtrack_url":null,"classifiers":["Development Status :: 3 - Alpha","Programming Language :: Python :: 3","Topic :: Software Development :: Libraries"],"description":"

\n \"AXL\n

\n\n

\n\n[![CI](https://github.com/AXLPROTOCOL/axl-core/actions/workflows/ci.yml/badge.svg)](https://github.com/AXLPROTOCOL/axl-core/actions/workflows/ci.yml)\n[![PyPI version](https://img.shields.io/pypi/v/axl-core.svg)](https://pypi.org/project/axl-core/)\n[![Python](https://img.shields.io/pypi/pyversions/axl-core.svg)](https://pypi.org/project/axl-core/)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Downloads](https://img.shields.io/pypi/dm/axl-core.svg)](https://pypi.org/project/axl-core/)\n\n

\n\n# axl-core\n\nThe Python implementation of the [AXL Protocol](https://axlprotocol.org) — parser, emitter, validator, translator, and CLI for the Agent eXchange Language.\n\n## What is AXL?\n\nAXL (Agent eXchange Language) is a universal communication protocol for agents and autonomous machines. A 133-line specification (the [Rosetta](https://axlprotocol.org/rosetta)) teaches any LLM the complete language on first read — achieving 95.8% comprehension across four major architectures. Two live experiments produced 1,502 packets with 100% parse validity across 11 agents from 10 computational paradigms.\n\n## Quick Start\n\n**Install:**\n\n```bash\npip install axl-core\n```\n\n**Parse a packet:**\n\n```python\nfrom axl import parse\n\npacket = parse(\"π:5:0xS:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG\")\nprint(packet.domain) # \"SIG\"\nprint(packet.tier) # 3\nprint(packet.agent_id) # \"5\"\nprint(packet.body.fields) # [\"BTC\", \"69200\", \"↓\", \"RSI\", \".64\"]\nprint(packet.flags) # [\"SIG\"]\n```\n\n**Emit a packet:**\n\n```python\nfrom axl import emit\nfrom axl.models import Body, Packet, PaymentProof, Preamble\n\npacket = Packet(\n preamble=Preamble(\n payment=PaymentProof(agent_id=\"8\", signature=\"0xPM\", gas=0.01),\n ),\n body=Body(domain=\"PAY\", tier=1, fields=[\"AXL-1\", \"0.02\", \"USDC\", \"local\", \"task_done\"]),\n flags=[\"LOG\"],\n)\nprint(emit(packet))\n# π:8:0xPM:0.01|S:PAY.1|AXL-1|0.02|USDC|local|task_done|LOG\n```\n\n**Validate:**\n\n```python\nfrom axl import parse, validate\n\nresult = validate(parse(\"π:5:0xS:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG\"))\nprint(result.valid) # True\nprint(result.errors) # []\n```\n\n**Translate:**\n\n```python\nfrom axl import parse\nfrom axl.translator import to_english, to_json\n\npacket = parse(\"π:5:0xS:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG\")\nprint(to_english(packet))\n# Agent 5: BTC at 69200, falling. RSI pattern detected with 64% confidence.\n\nprint(to_json(packet))\n# {\"domain\": \"SIG\", \"tier\": 3, \"fields\": {\"asset\": \"BTC\", \"price\": \"69200\", ...}}\n```\n\n## CLI Usage\n\n```bash\n# Parse a packet\naxl parse \"π:5:0xS:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG\"\n\n# Validate a packet\naxl validate \"π:5:0xS:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG\"\n\n# Translate to English\naxl translate --to english \"π:5:0xS:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG\"\n\n# Translate to JSON\naxl translate --to json \"π:5:0xS:0.001|S:SIG.3|BTC|69200|↓|RSI|.64|SIG\"\n\n# Emit a new packet\naxl emit --domain SIG --tier 3 --fields \"BTC,69200,↓,RSI,.64\" --flags \"SIG\"\n\n# Print version\naxl version\n```\n\n## Supported Domains\n\n| Domain | Purpose | Schema |\n|--------|---------|--------|\n| `OPS` | Infrastructure / operations | target, status, metric, value, threshold, action |\n| `SEC` | Security / threat detection | target, threat, severity, action, confidence |\n| `DEV` | Development / code lifecycle | repo, branch, status, action, author, confidence, risk |\n| `RES` | Research / analysis | topic, sources, confidence, finding |\n| `SIG` | Signal broadcast | asset, price, direction, pattern, confidence |\n| `COMM` | Communication / routing | from_agent, to_agent, intent, detail |\n| `TRD` | Trading / economic action | asset, price, momentum, vol, pattern, conf, action, size, lev, risk |\n| `PAY` | Payment transfer | payee, amount, currency, chain, memo |\n| `FUND` | Funding request | requester, to, amount, currency, reason, roi, balance, urgency |\n| `REG` | Registration / identity | name, pubkey, type, class, referrer |\n\nAll domains use positional encoding — field order is defined by the [Rosetta](https://axlprotocol.org/rosetta), and each field position carries a fixed semantic meaning.\n\n## How It Works\n\nAXL packets follow a pipe-delimited format where position defines meaning:\n\n```\n@rosetta_url | π:agent:sig:gas | T:timestamp | S:DOMAIN.TIER | fields... | FLAGS\n```\n\n- **`@rosetta`** — Self-bootstrapping pointer. First contact only.\n- **`π:proof`** — Payment proof: identity + signature + gas fee.\n- **`T:timestamp`** — Temporal ordering.\n- **`S:DOMAIN.TIER`** — Domain code + confidence tier (1–5).\n- **Fields** — Positional body fields per domain schema.\n- **Flags** — `LOG`, `STRM`, `ACK`, `URG`, `SIG`, `QRY`.\n\nFor the full specification, see the [Whitepaper](https://axlprotocol.org/whitepaper/) and the [Rosetta](https://axlprotocol.org/rosetta).\n\n## Links\n\n- [axlprotocol.org](https://axlprotocol.org) — Landing page\n- [Rosetta](https://axlprotocol.org/rosetta) — The 133-line language spec\n- [Whitepaper](https://axlprotocol.org/whitepaper/) — Full technical paper\n- [Experiment Results](https://axlprotocol.org/results/v2/) — Battleground v2 data\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE).\n\nCopyright 2026 AXLPROTOCOL INC.\n","description_content_type":"text/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":null,"license":"Apache-2.0","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"axl-core","package_url":"https://pypi.org/project/axl-core/","platform":null,"project_url":"https://pypi.org/project/axl-core/","project_urls":{"Documentation":"https://lang.axlprotocol.org","Homepage":"https://axlprotocol.org","Repository":"https://github.com/axlprotocol/axl-core"},"provides_extra":["dev"],"release_url":"https://pypi.org/project/axl-core/0.4.0/","requires_dist":["pytest>=7.0; extra == \"dev\"","ruff>=0.4; extra == \"dev\"","mypy>=1.0; extra == \"dev\""],"requires_python":">=3.10","summary":"AXL Protocol — Agent eXchange Language for autonomous machines","version":"0.4.0","yanked":false,"yanked_reason":null},"last_serial":35940735,"ownership":{"organization":null,"roles":[{"role":"Owner","user":"axlprotocol"}]},"urls":[{"comment_text":null,"digests":{"blake2b_256":"1246c4995787f6736dae5557f2ae730ddacfca7f96dac4a3e867a579473419d3","md5":"44079ef651a5966b08813b27f64e6add","sha256":"31cc8f2051ea7787fd0aeec6c7a130b08cb407207ea9d0906251213178041b90"},"downloads":-1,"filename":"axl_core-0.4.0-py3-none-any.whl","has_sig":false,"md5_digest":"44079ef651a5966b08813b27f64e6add","packagetype":"bdist_wheel","python_version":"py3","requires_python":">=3.10","size":19742,"upload_time":"2026-03-19T22:43:27","upload_time_iso_8601":"2026-03-19T22:43:27.390334Z","url":"https://files.pythonhosted.org/packages/12/46/c4995787f6736dae5557f2ae730ddacfca7f96dac4a3e867a579473419d3/axl_core-0.4.0-py3-none-any.whl","yanked":false,"yanked_reason":null},{"comment_text":null,"digests":{"blake2b_256":"5851fdcc7e061149ebdd141d693fd7353c366112da95da69986b2782866dd1e4","md5":"99651c9e070a4a23d4a7ded50de12159","sha256":"dc73c4158679776cf4619dacd1bb23b230a34014c420d2d0806a513d06b1c4e4"},"downloads":-1,"filename":"axl_core-0.4.0.tar.gz","has_sig":false,"md5_digest":"99651c9e070a4a23d4a7ded50de12159","packagetype":"sdist","python_version":"source","requires_python":">=3.10","size":21374,"upload_time":"2026-03-19T22:43:28","upload_time_iso_8601":"2026-03-19T22:43:28.470690Z","url":"https://files.pythonhosted.org/packages/58/51/fdcc7e061149ebdd141d693fd7353c366112da95da69986b2782866dd1e4/axl_core-0.4.0.tar.gz","yanked":false,"yanked_reason":null}],"vulnerabilities":[]}