Skip to main content

ASCENT

ASCII Successor with Compatible Encoding of Named Text

Live PyPI npm Release CI License: MIT

Keep every classic ASCII byte sacred. Ascend the rest without burning the stairs.

ASCENT Nexus v2.1.0 infographic: parse law, SkyPulse PATHHINT, dual-mode Starlink usable-goodput, Wire Lab 2.0, agents, multimodal, ASCENT-D

ASCENT Nexus v2.1.0 - SkyPulse PATHHINT architecture card · PNG · JPG · live


What it is

ASCENT is a wire encoding and control grammar for text, agents, multimodal references, quantum-safe control envelopes, and deep-space ECC profiles. It is a future-facing successor spirit to classic 7-bit ASCII (ANSI X3.4 / 1963):

Pillar Contract
Eternal identity Every byte less than 0x80 is classic ASCII, bit-identical, forever
Agent-native Fenced control tokens (ROLE, TOOL, THINK, ...) share the stream with prose
Multimodal Content-addressed refs and length-declared media units (no surrogate-pair hacks)
Quantum-safe control Append-only algorithm registry; no silent downgrade
Deep-space (ASCENT-D) Outer ECC frames; parity fail erases the unit (no mojibake)
SkyPulse (PATHHINT) LEO path foresight for usable session bandwidth; fail-closed skip; not an RF Mbps upgrade
Self-describing A valid document can carry plane maps, registries, and version history

This is not "Unicode but better." It is a stream contract greppers can still trust.

Live

https://ascent.jonbailey.xyz/

ASCENT Nexus Wire Lab 2.0 (architecture card v2.1.0): dual text/hex live sync, agent + multimodal composers, SkyPulse PATHHINT panel (LEO-IP vs D), ASCENT-D bit-error / erase-on-fail simulator, AEGIR sketch, interactive eleven-plane explorer, 2-minute tour, SPEC try-this, and codegen. Dual-mode Grok+Starlink plan (CLOUD / EDGE / QUEUE) with usable session bandwidth honesty. Sacred P0 meter and Hello, Universe sample included.

Follow: @suddenlyjon

Surface Version
Nexus site / architecture card 2.1.0
SPEC 1.0.0-rc1 (+ SkyPulse appendix)
Frozen Cont packing (ASCENT-V) Cont 0xA0-0xBF (5-bit)
Python package (PyPI) ascent-wire 2.1.0
JS package (npm) ascent-wire 2.1.0

Quick start

Browser

Open the live site and click Decode Hello, Universe.

Python reference decoder

python ref/ascent_decode.py --self-test
python ref/ascent_decode.py --hello
python ref/ascent_decode.py examples/hello-universe.ascent.bin --json

Golden tests (shared codec)

# from repo root
set PYTHONPATH=ref
python tests/test_ascent_codec.py

Shared library: ref/ascent_codec.py (ASCENT-7, frozen ASCENT-V, UTF-8 MM bridge). Lab non-ASCII modes on the live site: ASCENT-V / UTF-8 bridge / ASCENT-7 reject.

ASCENT-D + real satellite lab (ISS)

P9 outer frame with RS(255,223), erase-on-fail. Uses public Celestrak ISS TLE and a LEO BER channel model. No RF transmit.

set PYTHONPATH=ref
python tests/test_ascent_d_satellite.py

Module: ref/ascent_d.py.

SkyPulse PATHHINT (usable session bandwidth)

Fail-closed path hint for Starlink-class IP. Improves usable session bandwidth and continuity under LEO. Does not raise RF Mbps. Not a bare "bandwidth upgrade."

set PYTHONPATH=ref
python tests/test_skypulse.py
python -m ascent pathhint --profile ASCENT-E-LEO
python examples/ascent_starlink_client/daemon.py --pathhint

Docs: docs/SKYPULSE.md. Profile note: ASCENT-E-LEO (light CRC or short RS, no full P9 on interactive IP) vs ASCENT-D (spool/deep-space). Ship order: SPEC appendix + goldens + wire 2.1.0, then Wire Lab, then publish codec, LeoAware later.

AEGIR (ASCENT-native encryption companion)

AEGIR is a first-class P7 encryption suite: dual-core hybrid KEM (ML-KEM + X25519), History-Bound Outer Pad, agent-fenced ceremony (ROLE/CAP), Ghost Continuum IMS seals, and append-only registry (no silent downgrade). Design: design/AEGIR.md. Registry seeds: SPEC.md C.3.3.

set PYTHONPATH=ref
python ref/aegir_sketch.py --self-test
python ref/aegir_sketch.py --list-algs
python tests/test_aegir.py
# optional DCH-768 (requires: pip install kyber-py)
python ref/aegir_sketch.py --self-test

Parse law

if byte < 0x80:
    emit classic 7-bit ASCII (width 1)
    never recombine into a multi-byte unit
else:
    enter ASCENT extension grammar

Overlong encodings of 0x00-0x7F are illegal forever.

Hello, Universe (132 bytes)

One valid ASCENT-E stream:

  1. Greppable header ASCENT/1.0
  2. Human text Hello, Universe.
  3. Agent frame ROLE=guide
  4. Multimodal REF with SHA-256 binding

Agent frame alone:

9A C1 01 00 02 00 00 06 05 67 75 69 64 65 9B

Full hex map: SPEC.md section E.

Profiles

Profile Role
ASCENT-7 Pure classic ASCII identity
ASCENT-E Earth / general interchange
ASCENT-E-LEO Usage of E: PATHHINT + light integrity on LEO IP
ASCENT-D Deep-space outer ECC
ASCENT-A Archive / self-description heavy

Install (Python package)

Full guide: INSTALL.md · PyPI: https://pypi.org/project/ascent-wire/

pip install ascent-wire
ascent self-test
ascent encode --header --role guide "Hello, Universe."
python -m ascent hello

Package name: ascent-wire (import ascent). Requires Python 3.10+. Optional: pip install "ascent-wire[deep-space]".

Golden lock (JS must match Python)

set PYTHONPATH=ref
python tests/test_ascent_codec.py
node tests/run_js_lock.js
python tests/test_js_python_lock.py
python tests/test_skypulse.py

Agent loops

See docs/AGENT-LOOP.md for ROLE/TOOL/THINK/SAFETY recipes and docs/SPEC-FREEZE-1.0-RC.md for the 1.0-RC freeze checklist.

Repository layout

SPEC.md                 Normative draft (sections A-F)
ABSTRACT.md             One-page abstract
ascent/                 Installable package (ascent-wire)
pyproject.toml          Packaging
docs/                   Infographic, SkyPulse, agent-loop, SPEC freeze RC
ref/ascent_decode.py    Earth-profile reference decoder
ref/ascent_skypulse.py  PATHHINT policy + LEO-IP vs D integrity
ref/aegir_sketch.py     AEGIR encrypt/decrypt sketch (DEMO + optional DCH-768)
examples/               Canonical .bin samples (incl. skypulse-pathhint)
site/public/            Live Nexus Wire Lab 2.0 (Cloudflare Pages)
tests/                  Python goldens + JS lock
design/                 Non-normative design provenance (incl. AEGIR)
assets/masters/         Source OG + infographic masters
File Purpose
SPEC.md Full normative draft
ABSTRACT.md RFC-style one-pager
docs/ascent-infographic.png Architecture infographic v2.1.0 (SkyPulse; PNG may still show 2.0.3 until regen)
docs/SKYPULSE.md SkyPulse PATHHINT what/why/non-claims
docs/GROK-ASCENT-STARLINK-ARCHITECTURE.md Grok over ASCENT over Starlink design package
docs/ORBITSTACK-LEOAWARE-BRIDGE.md How LeoAware should consume PATHHINT
docs/ascent-starlink-interface.png Horizontal ASCENT x Starlink interface map (2400x1100)
examples/ascent_starlink_client/ Dual-mode CLI skeleton (cloud / edge / queue)
docs/AGENT-LOOP.md LLM agent loop guide
docs/SPEC-FREEZE-1.0-RC.md 1.0-RC freeze checklist
ref/ascent_decode.py Python decoder
ref/aegir_sketch.py AEGIR encryption sketch
design/AEGIR.md AEGIR companion design (full)
examples/hello-universe.ascent.bin Sample stream
examples/agent-loop-demo.ascent.bin Multi-frame agent sample
examples/hello-universe-aegir.ascent.bin Encrypted Hello (AEGIR-DEMO)

License

MIT - see LICENSE.

Support

GitHub Issues only. No personal contact required.


Pitchfork and Torch · open standards experiments

Release files for ascent-wire 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ascent-wire 2.1.0
File Size Uploaded
ascent_wire-2.1.0.tar.gz 42.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ascent-wire 2.1.0
File Interpreter ABI Platform
ascent_wire-2.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 76.1 kB

Release files / ascent_wire-2.1.0.tar.gz

Download URL ascent_wire-2.1.0.tar.gz
Size 42.3 kB
Tags Source
SHA-256 checksum
How to use checksums
3ba99e3f80750b42d78e9433360b7a3fac33fb3fddb5499fbf20675b39a0f303
BLAKE2b-256 checksum
How to use checksums
d757c67f0338a85564059ce05a023b1dae9fbd2aa74a4a24a0b2fd7f3a614fea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.

Transparency log

Release files / ascent_wire-2.1.0-py3-none-any.whl

Download URL ascent_wire-2.1.0-py3-none-any.whl
Size 33.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e0c3f53142a884b56d1a1b5f0b55939fcf53d514c08605c1d1bc17c28720f777
BLAKE2b-256 checksum
How to use checksums
1a159345992071297785a95ebf8256e5c5f8784f22ea0db6501f03f626413f4e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

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