Metadata-Version: 2.4
Name: nomad-scifm
Version: 0.2.0
Summary: MCP-Server for SciFMs
Project-URL: source, https://github.com/lanl/nomad
Project-URL: homepage, https://github.com/lanl/nomad
Project-URL: documentation, https://lanl.github.io/nomad
Project-URL: issues, https://github.com/lanl/nomad/issues
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=3.0.0
Requires-Dist: filelock>=3.13.0
Requires-Dist: mcp<2.0,>=1.20.0
Requires-Dist: pydantic<3.0,>=2.12.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: tantivy>=0.25.0
Requires-Dist: torch>=2.9.0
Requires-Dist: typer>=0.19.2
Requires-Dist: zstandard>=0.25.0
Requires-Dist: h5py>=3.15.1
Requires-Dist: truststore>=0.10.4
Requires-Dist: huggingface_hub<2.0,>=0.34.0
Requires-Dist: oras<1.0,>=0.2.42
Requires-Dist: thefuzz[speedup]>=0.22.1
Provides-Extra: otel
Requires-Dist: opentelemetry-api>=1.40.0; extra == "otel"
Requires-Dist: opentelemetry-sdk>=1.40.0; extra == "otel"
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.40.0; extra == "otel"
Dynamic: license-file

<p align="center">
  <img src="assets/icon.png" alt="Nomad icon" width="96">
</p>

# Nomad

Nomad connects AI agents to scientific foundation models (SciFMs). It serves
PyTorch-backed scientific tools over the [Model Context Protocol
(MCP)](https://modelcontextprotocol.io), and it can also expose MCP tools as
typed Python callables inside a code-execution sandbox.

[Documentation site](https://lanl.github.io/nomad) |
[Getting started](docs/guides/getting-started.md) |
[Model builder guide](docs/guides/model-builder.md) |
[Reference](docs/reference/index.md)

## What Nomad does

- Serve SciFMs and regular Python tools over MCP with `nomad serve`.
- Load model artifacts from Hugging Face, local storage, or Git/Git LFS.
- Proxy MCP servers into a Python sandbox with `nomad code-mode` and
  `nomad code-mode-exec`.
- Support both local workflows and hosting models on remote GPU servers.

## Install

Nomad requires Python 3.12 or newer.

For CLI use:

```shell
uv tool install --python 3.13 nomad-scifm

nomad --help
```

For development from a checkout:

```shell
uv sync --all-groups
uv run nomad --help
```

## Quick start

Launch the example server directly in MCP Inspector using stdio:

```shell
npx @modelcontextprotocol/inspector -- \
  uv run --directory container/demo \
  nomad serve nomad.yml
```

For the HTTP workflow and matching [URSA](https://github.com/lanl/ursa) configs, see
[Starting a Nomad server](docs/guides/getting-started.md#starting-a-nomad-server)
and
[Connect to a hosted Nomad server](docs/guides/getting-started.md#connect-to-a-hosted-nomad-server).

## Start here by task

| If you want to... | Start here |
| --- | --- |
| Connect to a running Nomad server | [Getting started](docs/guides/getting-started.md) |
| Host a new SciFM | [Model builder guide](docs/guides/model-builder.md) |
| Use Nomad for Inference | [Nomad inference notebook](docs/guides/nomad_inference.ipynb) |
| Browse CLI, config, and API docs | [Reference](docs/reference/index.md) |
| Run the demo deployment | [Deployments](docs/deployments/index.md) |
| Work on Nomad itself | [Developer docs](docs/guides/developer.md) |

## Development

Useful commands from a repo checkout:

```shell
uv run --only-group lint just lint
uv run --group dev just test
uv run --no-dev --group docs just docs
uv run --no-dev --group docs just docs-pdf
```

## Notice of Copyright Assertion (O5119)

© 2026. Triad National Security, LLC. All rights reserved.

This program was produced under U.S. Government contract 89233218CNA000001 for
Los Alamos National Laboratory (LANL), which is operated by Triad National
Security, LLC for the U.S. Department of Energy/National Nuclear Security
Administration. All rights in the program are reserved by Triad National
Security, LLC, and the U.S. Department of Energy/National Nuclear Security
Administration. The Government is granted for itself and others acting on its
behalf a nonexclusive, paid-up, irrevocable worldwide license in this material
to reproduce, prepare. derivative works, distribute copies to the public,
perform publicly and display publicly, and to permit others to do so.
