Main Sequence Logo

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 with normalized MetaTable contracts and TimeIndexTableUpdater producer workflows
deploy FastAPI services and supported application surfaces 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.

Repository 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
Major-version migrations: Migration guides

What this repository contains

This repository contains the SDK and documentation used to build and operate Main Sequence CodeRepositories.

Main package areas:

mainsequence.meta_tables: MetaTables, TimeIndexTableUpdaters, update workflows, and persistence
mainsequence.client: API client models for CodeRepositories, jobs, time-index tables, sharing, and platform resources
mainsequence.cli: the mainsequence command-line interface

Repository areas:

docs/: knowledge guides, CLI docs, and generated reference docs
tests/: automated tests

Documentation map

The documentation is organized into three reading modes:

Knowledge: deeper conceptual guides
CLI: command-focused operational documentation
Reference: generated API reference

Recommended entry points:

Beginner tutorial:
- MainSequence SDK tutorial CodeRepository
Knowledge:
Migrations:
CLI:
- CLI Overview

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 CodeRepositories:

mainsequence code-repository list

Create a new CodeRepository:

mainsequence code-repository create my-first-repository

Set it up locally:

mainsequence code-repository set-up-locally <CODE_REPOSITORY_UID>
cd my-first-repository
mainsequence code-repository build-local-venv --path .

From there, the normal learning path is:

model your first canonical table with a backend-managed MetaTable
create your first TimeIndexTableUpdater as an opinionated MetaTable-backed update workflow
understand sharing and RBAC for published tables
add an API or another application surface
schedule jobs
build supported application surfaces or downstream consumers
package the CodeRepository as an agent-facing surface when it 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 separate canonical tutorial CodeRepository linked above

If you are building a feature and already know the area:

go straight to the relevant guide in docs/knowledge/

If you are operating CodeRepositories day to day:

use docs/cli/ and the mainsequence --help command tree

If you need the exact SDK surface:

use docs/reference/

Package metadata

Package name: mainsequence
Python: >=3.13
CLI entry point: mainsequence

Package metadata is defined in pyproject.toml.

License

This repository is distributed under the terms described in LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mainsequence-8.1.0.tar.gz (535.4 kB view details)

Uploaded Sep 4, 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.

mainsequence-8.1.0-py3-none-any.whl (410.7 kB view details)

Uploaded Sep 4, 2026 Python 3

File details

Details for the file mainsequence-8.1.0.tar.gz.

File metadata

Download URL: mainsequence-8.1.0.tar.gz
Upload date: Sep 4, 2026
Size: 535.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mainsequence-8.1.0.tar.gz
Algorithm	Hash digest
SHA256	`e954a183fbc939775ce2ca3c731df33137a8f06428fa5d667a66ca607e839642`
MD5	`c05d50c0f3e1aff2c362780edd80932e`
BLAKE2b-256	`49349415ab300c78772d0bfa89f5dd699faee939fa4062962ad40c00ac001762`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mainsequence-8.1.0.tar.gz:

Publisher: publish-to-pypi.yml on mainsequence-sdk/mainsequence-sdk

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: mainsequence-8.1.0.tar.gz
- Subject digest: e954a183fbc939775ce2ca3c731df33137a8f06428fa5d667a66ca607e839642
- Sigstore transparency entry: 2713863011
- Sigstore integration time: Sep 4, 2026
Source repository:
- Permalink: mainsequence-sdk/mainsequence-sdk@2d8cb3de941919f655ee5585b81543e2817d7a32
- Branch / Tag: refs/tags/v8.1.0
- Owner: https://github.com/mainsequence-sdk
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-to-pypi.yml@2d8cb3de941919f655ee5585b81543e2817d7a32
- Trigger Event: push