Main Sequence Python SDK

The Main Sequence Python SDK is the client and development toolkit for the Main Sequence platform. It provides authentication, typed platform resources, CodeRepository development and release operations, Agent and A2A workflows, jobs, access policies, observability, logging, tracing, and reusable scaffold tooling.

MetaTables is now an independent domain package, installed as mainsequence-metatable and imported as metatables. Table models, time-index table updates, SQLAlchemy schemas, local database interfaces, and Alembic execution are no longer implemented by this distribution.

Repository Status

• Status: actively maintained
• Open issues: GitHub Issues
• Documentation: Documentation Site
• Security policy: SECURITY.md
• Release history: CHANGELOG.md
• Major-version migrations: Migration guides

What This Repository Contains

Main package areas:

• mainsequence.client: API client models for users, CodeRepositories, jobs, Agents, artifacts, constants, secrets, access policies, releases, and other platform resources
• mainsequence.cli: the complete mainsequence command-line interface for authentication, platform resources, and local CodeRepository operations
• mainsequence.instrumentation and mainsequence.logconf: SDK tracing and logging integration
• mainsequence.server: server-side caller assertion verification
• mainsequence.scaffold_skills: reusable, version-pinned skill copying for this SDK and extension libraries

Repository areas:

• agent_scaffold/skills/: version-matched SDK guidance and domain skills; repository-owned AGENTS.md files are never scaffolded or updated
• docs/: knowledge guides, CLI docs, architecture decisions, and generated reference docs
• tests/: offline tests plus explicitly marked live-backend tests

Documentation Map

Recommended entry points:

• Documentation home
• Authentication
• CLI overview
• Git source and Environment context
• Constants and Secrets
• Scheduling Jobs
• Resource releases
• Generated API reference
• MetaTables extraction guide
• ADR 0034

The beginner tutorial is maintained in the separate MainSequence SDK tutorial CodeRepository.

Quick Start

Install and authenticate:

pip install mainsequence
mainsequence login
mainsequence doctor

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.

Inspect and create CodeRepositories:

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

Use mainsequence --help and mainsequence code-repository --help for the installed command surface. The CLI includes Agent and AgentSession, CodeRepository, jobs and runs, images, resources and releases, constants, secrets, teams, access policies, scaffold, Docker, and local-development commands.

Python Client

mainsequence.client provides AuthLoaders, MainSequenceClient, generic request and response helpers, and typed platform adapters. The platform owns authorization and lifecycle policy. The SDK resolves CodeRepository source identity from the current Git checkout when an operation requires that context.

Discover deployments with ResourceRelease.filter(name=...) or resolve a known release UID with ResourceRelease.get(pk=...). For shared deployments owned by another repository, use the explicitly scoped filter_admin path. See Resource releases for supported filters and examples.

The standard mainsequence installation includes PyJWT and cryptography for the framework-independent caller assertion verifier. Applications remain responsible for resource authorization and storage operations.

Install mainsequence-metatable and import metatables for table-domain work. See the MetaTables migration guide for the install step, old and new imports, retired table CLI commands, and the legacy SDK option.

Development

This repository requires Python 3.13 or newer and uses pyproject.toml with a development dependency group.

uv sync --group dev
pytest
ruff check .
mkdocs build --strict

Live-backend tests are marked live and excluded from a normal test run. Run them explicitly with pytest -m live when credentials and a target backend are available.

Package metadata is defined in pyproject.toml. This repository is licensed under the MIT License; see LICENSE.