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.2.

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.2.tar.gz (69.9 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.2-py3-none-any.whl (76.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for scholialang-0.6.2.tar.gz
Algorithm Hash digest
SHA256 fbf2d64cfed2d21fd45bd7050ba7f0a81650f1f8c9c57edccf4755849cc08b64
MD5 0142fccc31e322e7476ab926cdd73b08
BLAKE2b-256 1cdaeda4b411425d65350c5b15454966d259e2bcd217cc9d41d8c999b48acc27

See more details on using hashes here.

Provenance

The following attestation bundles were made for scholialang-0.6.2.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.2-py3-none-any.whl.

File metadata

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

File hashes

Hashes for scholialang-0.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 39630e771ac52207dbde4bcffa92291c40b2990ee4c40849b54f4c08e873045a
MD5 2114f49f209f7ad3e4595ca9311094e6
BLAKE2b-256 24b84cc4617ecff178b8eec9229d71181ec19239ae5e74a291eaa6f24557a682

See more details on using hashes here.

Provenance

The following attestation bundles were made for scholialang-0.6.2-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