Metadata-Version: 2.4
Name: magma_core
Version: 2.0.1
Summary: Shared agent HTTP contracts, LLM workers, and robotics simulation abstractions for MAGMA
Author-email: Loan Bernat <l.bernat@sileane.com>
License-Expression: BSD-2-Clause
Project-URL: Homepage, https://magma-rob.github.io/
Project-URL: Repository, https://github.com/MAGMA-rob/magma-core
Project-URL: Issues, https://github.com/MAGMA-rob/magma-core/issues
Project-URL: Changelog, https://github.com/MAGMA-rob/magma-core/blob/main/CHANGELOG.md
Keywords: robotics,llm,agents,simulation,magma
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: torch<3,>=2.8
Requires-Dist: requests<3,>=2.34.2
Requires-Dist: PyYAML<7,>=6.0.3
Requires-Dist: pydantic<3,>=2.4
Requires-Dist: typing_extensions>=4.0
Provides-Extra: interface
Provides-Extra: simulation
Requires-Dist: mani_skill==3.0.1; extra == "simulation"
Requires-Dist: sapien==3.0.3; extra == "simulation"
Requires-Dist: numpy==1.26.4; extra == "simulation"
Requires-Dist: gymnasium==1.3.0; extra == "simulation"
Requires-Dist: transforms3d==0.4.2; extra == "simulation"
Provides-Extra: all
Requires-Dist: magma_core[simulation]; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest<10,>=8; extra == "dev"
Requires-Dist: fastapi<1,>=0.115; extra == "dev"
Requires-Dist: httpx<1,>=0.27; extra == "dev"
Dynamic: license-file

# magma-core

Shared agent HTTP contracts, LLM workers, configuration, serialization, dataset
export utilities, and robotics simulation abstractions for MAGMA.

Version **2.0.1** supports Python 3.12. The simulator-independent interface and the optional simulation dependencies are shipped in the same package. Simulation installation was checked on Linux x86_64; broader Python/platform support is not yet validated.

## Description

HTTP protocol `"2.0"` covers both inference and coaching. Coaching sessions use LLM backends and optional log capture; their payloads retain all context fields.

## Installation

### Pip

```bash
pip install "magma_core==2.0.1"              # Simulator-independent interface
pip install "magma_core[simulation]==2.0.1"  # Includes simulation dependencies
```

For a local checkout, use `pip install -e .` or `pip install -e ".[all]"`.
Extras add dependencies; they do not change which Python modules are shipped.
The default installation includes Torch, requests, PyYAML, Pydantic, and
`typing_extensions`, but does not require ManiSkill, SAPIEN, or Gymnasium.

### Github

```bash
pip install "git+https://github.com/MAGMA-rob/magma-core.git@main"
```

Install a pinned release tag:

```bash
pip install "magma_core[simulation] @ git+https://github.com/MAGMA-rob/magma-core.git@v2.0.1"
```

### Changelog

See [CHANGELOG.md](https://github.com/MAGMA-rob/magma-core/blob/main/CHANGELOG.md) for release changes. Core is distributed under the BSD 2-Clause license.

Report problems through the
[issue tracker](https://github.com/MAGMA-rob/magma-core/issues).
