Multi-Agent Interface Layer v2 workspace meta-package
Project description
Multi-Agent Interface Layer (MAIL)
MAIL is a protocol and Python implementation for message-oriented coordination between humans, agents, daemons, and swarms.
This repository is being reorganized for MAIL v2. The active implementation is
split into package-specific workspaces, while the older MAIL v1 reference
runtime is archived under src/mail/legacy.
Active v2 Packages
src/mail/protocol- shared protocol types and constants (mail-protocol)src/mail/server- FastAPI server implementation (mail-server)src/mail/client- command-line client (mail-client)src/mail/daemon- daemon implementation (mail-daemon)
Repository Layout
mail/
├── docs/ # v2 repository-level docs
├── spec/ # protocol specification and schemas
├── src/mail/
│ ├── protocol/ # mail-protocol package
│ ├── server/ # mail-server package
│ ├── client/ # mail-client package
│ ├── daemon/ # mail-daemon package
│ └── legacy/ # archived MAIL v1 runtime, docs, config, and UI
├── tests/ # active MAIL v2 test suite
├── scripts/ # repository maintenance scripts
└── pyproject.toml # uv workspace and meta-package configuration
Development
Install the workspace dependencies:
uv sync
Run the v2 server:
uv run mail-server
Use the v2 client:
uv run mail --help
Run active v2 tests:
uv run pytest
During the transition, some root-level scripts still target the legacy runtime.
Legacy tests and other v1 material live under src/mail/legacy.
Run archived legacy tests explicitly:
uv run --extra legacy pytest src/mail/legacy/tests
Documentation
- Root v2 docs:
docs/README.md - Protocol/specification:
spec/ - Server docs:
src/mail/server/docs/ - Client docs:
src/mail/client/docs/ - Legacy runtime notes:
src/mail/legacy/README.md - Archived v1 docs:
src/mail/legacy/docs/
Legacy Runtime
The MAIL v1 runtime is kept for compatibility and historical reference. Use
mail.legacy.* imports for archived code as it is migrated into the legacy
namespace.
Do not add new v2 behavior to the legacy runtime unless it is needed for a specific compatibility or migration task.
Licensing
Reference implementation code is licensed under Apache License 2.0. Protocol specification materials are covered by their repository license files.
Release history Release notifications | RSS feed
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 mail_swarms-2.0.1.tar.gz.
File metadata
- Download URL: mail_swarms-2.0.1.tar.gz
- Upload date:
- Size: 70.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
556e9e8db35fe9fdaa4265142770fd2e909d724f499264229133514404d3999b
|
|
| MD5 |
47a2f6a61ecf229db4ae3948286f75e0
|
|
| BLAKE2b-256 |
514663f5b843c44ac8ec772434cb9f9243992c037fb8fe34e583a2a1fc28c29d
|
File details
Details for the file mail_swarms-2.0.1-py3-none-any.whl.
File metadata
- Download URL: mail_swarms-2.0.1-py3-none-any.whl
- Upload date:
- Size: 70.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
079dcb7b0c65bced4af54dfc12c5e1ca23330ad8e1a77521a4a4a021572e0290
|
|
| MD5 |
76887c22578748832f15b7909e81fe80
|
|
| BLAKE2b-256 |
760db0cf27563b5a8d7bf16c4467170ea6f164c462ff8a70dbd49b1933b97269
|
