MAS Lab — Packages Reference

Auto-generated from pyproject.toml files and library.yaml manifests. Run task docs-gen to refresh after adding or modifying packages.

Summary

Package	Layer	Description	CLI
mas-runtime	Runtime core	MAS Runtime V2 — Mealy kernel (embeddable library)	mas-runtime
mas-ctl	Orchestration	MAS control plane V2 — compose, session, placement	mas-ctl
mas-lab	Lab framework	MAS Lab — Multi-Agent System experimentation, benchmarking, and analysis toolkit.	mas-lab
mas-lab-core	Lab framework	Core contracts, telemetry, schemas and utilities shared across MAS Lab components.	—
mas-lab-bench	Lab framework	Benchmark engine, pipeline execution, plots and validation for MAS Lab.	—
mas-lab-controller	Lab framework	MAS Lab controller daemon — workers, IPC, HTTP API for CLI and UI.	—
mas-lab-content	Lab framework	Shared content engine — markdown with widget directives, themes, and multi-mode rendering	—
mas-library-standard	Libraries	Standard library for MAS — infra bundles, tools, and pattern aliases.	—
mas-library-eval	Libraries	Evaluation and quality metrics library for MAS Lab — MCE integration.	—
mas-library-lab	Libraries	MAS Lab provider library with public eval plugins.	—
mas-library-samples	Libraries	Community-contributed MAS sample apps, datasets, and tools.	—
---

Installation

Minimal install (core toolchain)

Installs the four core packages needed to run and orchestrate agents, execute benchmarks, and call mas-lab.

# From the repository root (uses UV_PROJECT_ENVIRONMENT if set):
task install
# Equivalent to:
uv pip install -e runtime -e ctl -e library-standard -e lab

Full install (all packages + optional extras)

This is not a minimal install — it covers every package in this repository plus all optional feature extras. Use this when you need evaluation metrics, or community sample apps.

uv pip install \
  -e runtime \
  -e ctl \
  -e library-standard \
  -e lab \
  -e library-eval \
  -e library-lab \
  -e library-samples

See Tutorial 0 — Environment Setup for the complete walkthrough including LLM endpoint wiring and verification.

---

Package Details

mas-runtime

Install path: runtime
Layer: Runtime core
MAS Runtime V2 — Mealy kernel (embeddable library)

uv pip install -e runtime  # core
uv pip install -e "runtime[grpc,otel,dev]"  # with all extras

Optional extras:

Extra	Packages / features
grpc	grpcio>=1.60.0, grpcio-tools>=1.60.0
otel	opentelemetry-api>=1.42.0, opentelemetry-sdk>=1.42.0, opentelemetry-exporter-otlp>=1.42.0
dev	pytest>=8.0, pytest-asyncio>=0.24

CLI commands:

Command	Entry point
mas-runtime	mas.runtime.cli.main:main

---

mas-ctl

Install path: ctl
Layer: Orchestration
MAS control plane V2 — compose, session, placement

uv pip install -e ctl  # core
uv pip install -e "ctl[curses,dev]"  # with all extras

Depends on: mas-runtime

Optional extras:

Extra	Packages / features
curses	windows-curses>=2.3.2; sys_platform == 'win32'
dev	pytest>=8.0, import-linter>=2.0

CLI commands:

Command	Entry point
mas-ctl	mas.ctl.cli.main:main

---

mas-lab

Install path: lab
Layer: Lab framework
MAS Lab — Multi-Agent System experimentation, benchmarking, and analysis toolkit.

uv pip install -e lab  # core
uv pip install -e "lab[extensions]"  # Letta memory scenarios (`extensions.lab`)

Depends on: mas-runtime, mas-ctl, mas-lab-core, mas-lab-bench, mas-lab-controller, mas-library-eval

Optional extras:

Extra	Packages / features
extensions	letta (Letta memory scenarios in extensions.lab)
all	same as extensions

For paper labs with Letta: uv sync --group labs-full or pip install 'mas-lab[extensions]'. Extended OTel/KG observability is not an OSS extra — see mas-lab-internal.

CLI commands:

Command	Entry point
mas-lab	mas.lab.cli:app

---

mas-lab-core

Install path: lab/components/core
Layer: Lab framework
Core contracts, telemetry, schemas and utilities shared across MAS Lab components.

uv pip install -e lab/components/core

Depends on: mas-runtime

Entry-point group mas.lab.controller.plugins: registers 1 item(s) in lab.controller.plugins.

---

mas-lab-bench

Install path: lab/components/bench
Layer: Lab framework
Benchmark engine, pipeline execution, plots and validation for MAS Lab.

uv pip install -e lab/components/bench

Depends on: mas-lab-core, mas-library-eval, mas-runtime, mas-ctl

Entry-point group mas.lab.runners: registers 1 item(s) in lab.runners.

---

mas-lab-controller

Install path: lab/components/controller
Layer: Lab framework
MAS Lab controller daemon — workers, IPC, HTTP API for CLI and UI.

uv pip install -e lab/components/controller  # core
uv pip install -e "lab/components/controller[dev]"  # with all extras

Depends on: mas-lab-core, mas-lab-bench, mas-runtime, mas-ctl

Optional extras:

Extra	Packages / features
dev	pytest>=9.0, pytest-asyncio, pytest-cov>=6.0, httpx>=0.27

Entry-point group mas.lab.cli.components: registers 1 item(s) in lab.cli.components.

---

mas-lab-content

Install path: lab/components/content
Layer: Lab framework
Shared content engine — markdown with widget directives, themes, and multi-mode rendering

uv pip install -e lab/components/content

---

mas-library-standard

Install path: library-standard
Layer: Libraries
Standard library for MAS — infra bundles, tools, and pattern aliases.

uv pip install -e library-standard

Depends on: mas-runtime

Entry-point group mas.runtime.manifest_libraries: registers 1 item(s) in runtime.manifest_libraries.

---

mas-library-eval

Install path: library-eval
Layer: Libraries
Evaluation and quality metrics library for MAS Lab — MCE integration.

uv pip install -e library-eval  # core
uv pip install -e "library-eval[dev]"  # with all extras

Depends on: mas-lab-core, mas-lab-bench, mas-runtime

Optional extras:

Extra	Packages / features
dev	pytest>=7.0.0, pytest-asyncio>=0.21.0

Entry-point group mas.lab.cli.components: registers 1 item(s) in lab.cli.components.

---

mas-library-lab

Install path: library-lab
Layer: Libraries
MAS Lab provider library with public eval plugins.

uv pip install -e library-lab

Depends on: mas-lab

Entry-point group mas.lab.eval.plugins: registers 1 item(s) in lab.eval.plugins.

---

mas-library-samples

Install path: library-samples
Layer: Libraries
Community-contributed MAS sample apps, datasets, and tools.

uv pip install -e library-samples

Entry-point group mas.runtime.manifest_libraries: registers 1 item(s) in runtime.manifest_libraries.

---