openmas 0.1.0

OpenMAS: A lightweight SDK for building Multi-Agent Systems

OpenMAS

Build Intelligent Agent Systems

OpenMAS is a lightweight Python SDK for building asynchronous Multi-Agent Systems (MAS) with first-class support for the Model Context Protocol (MCP).

It provides the essential tools and patterns to create sophisticated, independent agents that can communicate, coordinate, and interact with AI models and services.

Full Documentation: https://docs.openmas.ai

Key Features

• Simplified Agent Development: Build agents inheriting from BaseAgent with a clear asynchronous lifecycle (setup, run, shutdown).
• Flexible Communication: Pluggable communicators for HTTP, Model Context Protocol (SSE & Stdio), and experimental support for gRPC and MQTT, with lazy loading to keep dependencies minimal. Easily extend with custom communicators. See Communication.
• Environment Configuration: Easily configure agents via environment variables or configuration files.
• Testing Utilities: Includes tools like MockCommunicator and AgentTestHarness.
• Deployment Ready: CLI tools to help generate Dockerfiles.
• Agent Patterns: Built-in support for patterns like Orchestrator-Worker.
• Package Management: Git-based dependency management for agents using openmas deps.
• Structured Projects: Standardized directory layout (agents/, shared/, extensions/, packages/) generated by openmas init promotes modularity and maintainability. See Project Structure.

Installation

pip install openmas

OpenMAS has optional extras for different communication protocols ([mcp], [grpc], [mqtt], [all]).

See the full Installation Guide for details on prerequisites, virtual environments, and optional dependencies.

Quick Start

The best way to get started with OpenMAS is by following our detailed tutorial, which guides you through creating and running your first agent using the standard project structure:

• Getting Started Guide

This guide uses the openmas init command to set up a project with the proper directory structure and openmas run to execute the agent.

Contributing

Contributions are welcome! Please see the Contributing Guide for details on how to get involved, set up your development environment, run tests (tox), and submit pull requests.

License

OpenMAS is licensed under the MIT License.