Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

MetaTables logo

Main Sequence logo

MetaTables

MetaTables is a Python client and API for describing, registering, querying, and updating database tables through a governed catalog.

Its PyPI distribution is mainsequence-metatable; imports and the command are named metatables. See publishing for the release process and the current published SDK prerequisite.

The Python client provides SQLAlchemy table definitions, application-table migrations, query objects, time-index readers and update processes, and the metatables command. The MetaTables API stores table identities, contracts, permissions, and update history, and executes authorized operations on physical databases.

A catalog record describes a table; the table's rows live in its DataSource. The Main Sequence SDK supplies platform authentication, identity, repository context, and platform Secrets. MetaTables owns its table behavior and storage adapters. Local development runs the same API with one SQLite database for system metadata and table rows. Initialize it explicitly through Settings; startup never runs Alembic.

Start here

The documentation index separates client, API, operations, and contributor guides. The capability reference records implemented and unavailable operations, including inherited methods and CLI commands. Runnable guide assets live in examples.

Client skills

Copy the installed client's skills into a consuming application explicitly:

metatables copy-metatables-skills --path /path/to/application

The local development skill guides application work through local SQLite setup, verified test writes, and an explicit switch back to the intended environment. The other skills cover table contracts, application migrations and producers.

The command uses the Main Sequence SDK helper, writes to .agents/skills/metatables/, and records the client version. It works without login or an API. Use --dry-run to preview the copy, or put global --json before the command for structured output. See installation for refresh behavior and the bundled references.

Development

Python 3.13 or newer is required. The package selects the published compatible SDK:

python -m pip install -e '.[dev,docs]'
python -m metatables.sdk_compat
python -m pytest -q
python -m scripts.check_project
mkdocs build --strict

Physical PostgreSQL checks use explicitly configured disposable databases; see testing. No separate frontend is needed to use the Python client or run the API.

License

MetaTables is licensed under the MIT License. See LICENSE for the complete terms.

Metadata

Release files for mainsequence-metatable 0.1.60.dev91

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

Source distribution (sdist)

Source distribution for mainsequence-metatable 0.1.60.dev91
File Size Uploaded Provenance Actions
mainsequence_metatable-0.1.60.dev91.tar.gz 1.3 MB With provenance Details for mainsequence_metatable-0.1.60.dev91.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mainsequence-metatable 0.1.60.dev91
File Interpreter ABI Platform Actions
mainsequence_metatable-0.1.60.dev91-py3-none-any.whl Python 3 none any Details for mainsequence_metatable-0.1.60.dev91-py3-none-any.whl

Total release size: 3.9 MB

Release files / mainsequence_metatable-0.1.60.dev91.tar.gz

Download URL mainsequence_metatable-0.1.60.dev91.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
09ead30afa152bbcfacd0a261805f5c5cdc943ed3475e7a0aa6f3b7b18e5999c
BLAKE2b-256 checksum
How to use checksums
08a55cc5a045779d6b67d9ed91cebdfc55bfc421d013c42048c7ffede86c8140
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 10, 2026.

Transparency log

Release files / mainsequence_metatable-0.1.60.dev91-py3-none-any.whl

Download URL mainsequence_metatable-0.1.60.dev91-py3-none-any.whl
Size 2.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
2e43f42ca9d107ab57b37d06c211812d9c7c5da656858606364f1d6ad8054831
BLAKE2b-256 checksum
How to use checksums
8dafc895552f6b9d63eecb2b9ee98ad06595c0d937e81986fa00387ea12b168d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 10, 2026.

Transparency log

Security for mainsequence-metatable 0.1.60.dev91

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mainsequence_metatable-0.1.60.dev91.tar.gz

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 Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
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