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

scholialang-spec - language specification and fixture corpus
scholialang-mcp - MCP, LSP, and host plugin tooling

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:

Spec: https://scholialang.org/spec
What's new in v0.6: https://scholialang.org/whats-new-in-v0.6
Eval summary: https://scholialang.org/eval-summary

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.7.2.tar.gz (72.0 kB view details)

Uploaded Aug 6, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

scholialang-0.7.2-py3-none-any.whl (78.6 kB view details)

Uploaded Aug 6, 2026 Python 3

File details

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

File metadata

Download URL: scholialang-0.7.2.tar.gz
Upload date: Aug 6, 2026
Size: 72.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for scholialang-0.7.2.tar.gz
Algorithm	Hash digest
SHA256	`d5162d200a26b5f134287020a983808510fc0cfbe3a0ec204520878daf2a0db9`
MD5	`471ddb1ba4335b6b4dc0f5e6ed82206f`
BLAKE2b-256	`fbe4e3bf3ad4c07d44488bd3520ffd6b0f43eb0233b43ad4d85b006090ee1dc7`

See more details on using hashes here.

Provenance

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: scholialang-0.7.2.tar.gz
- Subject digest: d5162d200a26b5f134287020a983808510fc0cfbe3a0ec204520878daf2a0db9
- Sigstore transparency entry: 2361807336
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: dougfirlabs/scholialang@192a5176caddd3150caa08b8589314ae3ecc525f
- Branch / Tag: refs/heads/main
- Owner: https://github.com/dougfirlabs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@192a5176caddd3150caa08b8589314ae3ecc525f
- Trigger Event: workflow_dispatch