Skip to main content

Scholia reference implementation (parser, validator, core primitives): helps agentic systems preserve reasoning state, use tools without quality loss, and reduce context cost across long-horizon work

Project description

Scholialang

Website · Spec · MCP · Python · Doug Fir Labs

scholialang

Scholia helps agentic systems preserve reasoning state, use tools without quality loss, and reduce context cost across long-horizon work. scholialang is the Python reference implementation of the language: the parser, validator, and core primitives that make Scholia traces portable, inspectable, and reusable across sessions.

Scholia v0.6 builds on content-addressed reasoning traces. The v0.6 language keeps the v0.5 closed vocabulary and adds the content-addressed substrate: optional canonical_id hashes, a canonical-id-keyed DAG registry, and the three core lazy-prelude modes hash_only, hash_list, and inline.

It contains the language-level pieces only:

  • atom dataclasses
  • parser
  • validator
  • canonical_id hashing
  • DAG registry primitives
  • lazy prelude rendering
  • stable atom IDs
  • metadata helpers
  • JSON/YAML serializers
  • Markdown/XML renderers

Host-runtime concerns such as trace persistence, enrichment, adjudication, and proof-graph bridging live outside this package.

Current v0.6 Scope

scholialang owns the language runtime for the v0.6 scope: the 32-kind closed vocabulary inherited from v0.5, optional canonical_id computation and validation, canonical-id-aware reference resolution, the local DAG registry primitive, and the three finalized lazy-prelude modes. MCP servers, editor clients, host plugins, and public launch pages live in sibling repositories.

Install

pip install scholialang

For local development:

pip install -e '.[dev]'
pytest

Related Repositories

This package tracks Scholia language version v0.6.0.

License

The scholialang reference implementation is dual-licensed under either MIT or Apache-2.0, at your option. See LICENSE, LICENSE-MIT, and LICENSE-APACHE.

The normative specification prose lives in scholialang-spec and is licensed separately under CC-BY-4.0.

Useful launch links:

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

scholialang-0.6.1.tar.gz (69.0 kB view details)

Uploaded Source

Built Distribution

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

scholialang-0.6.1-py3-none-any.whl (75.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: scholialang-0.6.1.tar.gz
  • Upload date:
  • Size: 69.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for scholialang-0.6.1.tar.gz
Algorithm Hash digest
SHA256 1216ec75263ff37ec66c0707533193c28e6d7c48a1777b2cb575684919b546ea
MD5 927136dfcec88abe134f689151a8161f
BLAKE2b-256 e64bd948d65061e7bef86bdcee74da14d6ac4189216de3ae95eec5210ec6f032

See more details on using hashes here.

Provenance

The following attestation bundles were made for scholialang-0.6.1.tar.gz:

Publisher: publish.yml on dougfirlabs/scholialang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

  • Download URL: scholialang-0.6.1-py3-none-any.whl
  • Upload date:
  • Size: 75.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for scholialang-0.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 164caaf8f094b8f4ed4d65b75cf5bdd44acfbc4e9cc75f41a9552f3c888e2ecc
MD5 691f1b9d7b6f3931138c0401fd7309de
BLAKE2b-256 60b03afe8c5642f8b0399adc93bb1c99ad3e123e6223fb107fc89319baede3eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for scholialang-0.6.1-py3-none-any.whl:

Publisher: publish.yml on dougfirlabs/scholialang

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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