nauro-core
Shared pure-Python library for the Nauro ecosystem. Provides parsing, validation, context assembly, and constants used by both the Nauro CLI and the remote MCP server.
Installation
pip install nauro-core
What's inside
decision_model— the PydanticDecisionmodel plus compiled regexes andparse_decision/format_decisionfor the Nauro markdown protocol (decision titles, metadata fields, section headers)constants— limits, thresholds, valid values, file paths shared across all Nauro surfacesparsing— pure markdown→data helpers:extract_stack_summary,decisions_summary_lines(decision parsing lives indecision_model.parse_decision, which returns a validatedDecision)context—build_l0/build_l1/build_l2context assembly from pre-loaded files and parsed decisionsvalidation: structural screening, hash dedup, and BM25 retrieval of related decisions
Design principles
- No I/O — no filesystem, no network; callers inject pre-loaded data. Runtime dependencies are compute-only (BM25, parsing, validation); embeddings are an optional extra (
nauro-core[embeddings]) - Function injection — callers pass pre-loaded data (
files: dict[str, str],decisions: list[dict]); nauro-core never reads files or calls APIs - Import isolation — enforced via
import-linter: nauro-core cannot import fromnauroormcp_server
Usage
from nauro_core import parse_decision, build_l0, compute_hash
# Parse a decision markdown file
decision = parse_decision(markdown_content, "042-use-s3.md")
# Build L0 context from pre-loaded files
context = build_l0(files={"state.md": state, "stack.md": stack}, decisions=decisions)
# Check for duplicate decisions
hash_val = compute_hash(title="Use S3 for storage", rationale="...")
License
Apache 2.0
1 maintainer
Metadata
1 maintainer
Release files for nauro-core 1.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nauro_core-1.17.0.tar.gz | 293.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nauro_core-1.17.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 451.0 kB
Release files / nauro_core-1.17.0.tar.gz
| Download URL | nauro_core-1.17.0.tar.gz |
|---|---|
| Size | 293.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
62ddb21aefebf49ca8e1dd2eee74a0b77af600339a2e042cf0b1bf79b1081de2
|
|
BLAKE2b-256 checksum How to use checksums |
5269c6b9d3cddbc34cbd8f430d8515099e409e90c2ac979e63f272b95acf15e4
|
| 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 Sep 30, 2026.
Transparency logRelease files / nauro_core-1.17.0-py3-none-any.whl
| Download URL | nauro_core-1.17.0-py3-none-any.whl |
|---|---|
| Size | 157.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1a9838619156163ab72b30ce92d173014b6b2fb749f78c95f494bf7d05732759
|
|
BLAKE2b-256 checksum How to use checksums |
c5974b8d0173cdaf4841e244f3862adea1367f98015203edf9d00e1bb4381f17
|
| 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 Sep 30, 2026.
Transparency log
