Main Sequence Python SDK
The Main Sequence Python SDK is the client and development toolkit for the Main Sequence platform.
The Main Sequence platform allows you to:
- rapidly build and deploy data products and data workflows as a unified API with normalized table contracts through
MetaTables andDataNodes - rapidly deploy RBAC-enabled dashboards on the platform
- rapidly deploy agents using the Google Agent SDK
The key idea is that you can focus on development and deployment, while the platform handles the DevOps layer.
Project Status
- Status: actively maintained
- Last commit:
2026-03-27-6aa5dea-docs logo fix v.3.17.6 - Open issues: GitHub Issues
- Documentation: Documentation Site
- Security policy: SECURITY.md
- Release history: CHANGELOG.md
What this repository contains
This repository contains the SDK and the documentation used to build and operate Main Sequence projects.
Main package areas:
mainsequence.meta_tables:MetaTables,DataNodes, update workflows, and persistencemainsequence.client: API client models for projects, jobs, data node storages, sharing, and platform resourcesmainsequence.cli: themainsequencecommand-line interface
Repository areas:
docs/: tutorials, knowledge guides, CLI docs, and generated reference docsexamples/: worked examples and usage patternstests/: automated tests
Documentation map
The documentation is organized into four reading modes:
- Tutorial: the guided learning path
- Knowledge: deeper conceptual guides
- CLI: command-focused operational documentation
- Reference: generated API reference
Recommended entry points:
- Tutorial:
- Knowledge:
- CLI:
Quick start
Install the package:
pip install mainsequence
Authenticate:
mainsequence login
An already MCP-authenticated coding agent can establish the same persisted CLI
session with mainsequence login --mcp, then call the printed
auth.cli_authorize tool while the command waits. The backend supplies the
callback URI; tokens return directly to the CLI and are never exposed through
MCP.
Check that you can see your projects:
mainsequence project list
Create a new project:
mainsequence project create my-first-project
Set it up locally:
mainsequence project set-up-locally <PROJECT_ID>
cd my-first-project
mainsequence project build_local_venv --path .
From there, the normal learning path is:
- model your first canonical table with a backend-managed
MetaTable - create your first
DataNodeas an opinionated MetaTable-backed update workflow - understand sharing and RBAC for published tables
- add an API or another application surface
- schedule jobs
- build dashboards or downstream consumers
- package the project as an agent-facing surface when the repository is ready
Installation for development
This repository uses pyproject.toml and a development dependency group.
With uv:
uv sync --group dev
Or with pip, install the package and the docs/test tools you need separately.
Common development commands
Run the CLI:
mainsequence --help
Run tests:
pytest
Serve the docs locally:
mkdocs serve
Build the docs:
mkdocs build
Lint the code:
ruff check .
Format the code:
black .
How to read this repository
If you are evaluating the platform:
- start with the tutorial in
docs/tutorial/
If you are building a feature and already know the area:
- go straight to the relevant guide in
docs/knowledge/
If you are operating projects day to day:
- use
docs/cli/and themainsequence --helpcommand tree
If you need the exact SDK surface:
- use
docs/reference/
Package metadata
- Package name:
mainsequence - Python:
>=3.13 - CLI entry point:
mainsequence
Project metadata is defined in pyproject.toml.
License
This repository is distributed under the terms described in LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mainsequence-6.0.23.tar.gz.
File metadata
- Download URL: mainsequence-6.0.23.tar.gz
- Upload date:
- Size: 496.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
88297fbed1aedd238bfa11110d0131d2ec1a9da2a2c76e4779fbbb6b0d6ce4c8
|
|
| MD5 |
dfccecaf844fbcbbb8239a6160a528ff
|
|
| BLAKE2b-256 |
c363b4cbc277d99ac1c082b5ae747401e5c0cc2f4740f78a8242760cb94649fb
|
Provenance
The following attestation bundles were made for mainsequence-6.0.23.tar.gz:
Publisher:
publish-to-pypi.yml on mainsequence-sdk/mainsequence-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mainsequence-6.0.23.tar.gz -
Subject digest:
88297fbed1aedd238bfa11110d0131d2ec1a9da2a2c76e4779fbbb6b0d6ce4c8 - Sigstore transparency entry: 2420780544
- Sigstore integration time:
-
Permalink:
mainsequence-sdk/mainsequence-sdk@9556bb26e855dbcf311e24ad08214ad5bc491586 -
Branch / Tag:
refs/tags/v6.0.23 - Owner: https://github.com/mainsequence-sdk
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@9556bb26e855dbcf311e24ad08214ad5bc491586 -
Trigger Event:
push
-
Statement type:
File details
Details for the file mainsequence-6.0.23-py3-none-any.whl.
File metadata
- Download URL: mainsequence-6.0.23-py3-none-any.whl
- Upload date:
- Size: 395.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9c13dc70bf66745fcada98353820bcf6bd9a5a1ddc7b98e2915c0c03da15bcb3
|
|
| MD5 |
bc897300145a027f8cc3ce19819c3083
|
|
| BLAKE2b-256 |
05506fa06d0212270ea9fe6536d7f542c030a8c0b4a2d94ec01fa4de72454882
|
Provenance
The following attestation bundles were made for mainsequence-6.0.23-py3-none-any.whl:
Publisher:
publish-to-pypi.yml on mainsequence-sdk/mainsequence-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mainsequence-6.0.23-py3-none-any.whl -
Subject digest:
9c13dc70bf66745fcada98353820bcf6bd9a5a1ddc7b98e2915c0c03da15bcb3 - Sigstore transparency entry: 2420780559
- Sigstore integration time:
-
Permalink:
mainsequence-sdk/mainsequence-sdk@9556bb26e855dbcf311e24ad08214ad5bc491586 -
Branch / Tag:
refs/tags/v6.0.23 - Owner: https://github.com/mainsequence-sdk
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@9556bb26e855dbcf311e24ad08214ad5bc491586 -
Trigger Event:
push
-
Statement type:
