Skip to main content

coreason-catalog

Dynamic Registry and Routing Plane for the CoReason Ecosystem

coreason-catalog serves as the "Cartographer" and active gateway for the CoReason data mesh. It enables agents to discover data sources based on semantic meaning and enforces data sovereignty policies at query time.

Core Philosophy: "The Map controls the Territory. Route by Meaning, Filter by Policy."

Key Features:

  • Zero-Copy Storage: The Catalog stores only metadata pointers (source_pointer) to external data, never raw content.
  • Delegated Identity: strict access control using UserContext passports and coreason-identity shared kernel.

Documentation

Full documentation is available in the docs/ folder:

Getting Started

Prerequisites

  • Python 3.12+
  • Poetry

Installation

  1. Clone the repository:
    git clone https://github.com/CoReason-AI/coreason-catalog.git
    cd coreason-catalog
    
  2. Install dependencies:
    poetry install
    

Running the Server

To start the catalog server locally:

poetry run uvicorn coreason_catalog.main:app --reload

Development

  • Run the linter:
    poetry run pre-commit run --all-files
    
  • Run the tests:
    poetry run pytest
    

Metadata

Release files for coreason-catalog 0.4.1

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

Source distribution (sdist)

Source distribution for coreason-catalog 0.4.1
File Size Uploaded
coreason_catalog-0.4.1.tar.gz 16.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for coreason-catalog 0.4.1
File Interpreter ABI Platform
coreason_catalog-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 39.1 kB

Release files / coreason_catalog-0.4.1.tar.gz

Download URL coreason_catalog-0.4.1.tar.gz
Size 16.6 kB
Tags Source
SHA-256 checksum
How to use checksums
3a677f66351c67441673d502cf4ede70871b46d9b5f5981fb891c8b37f5adc1c
BLAKE2b-256 checksum
How to use checksums
d6895226af84434a81a34e1c03fb39a6ca6ac3332457ee77b0f94db7fcba4f58
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Jan 28, 2026.

Transparency log

Release files / coreason_catalog-0.4.1-py3-none-any.whl

Download URL coreason_catalog-0.4.1-py3-none-any.whl
Size 22.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eb46360023261cc3a002d352e8be383ba7c925d2aa9aede79b3cab5389a51b1d
BLAKE2b-256 checksum
How to use checksums
58dd4c279e093737c05e79012ae4feccefbf76140a5c4e562c0644a39db74b19
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Jan 28, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

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