Skip to content

Installation

Requirements

  • Python 3.12 or higher
  • uv (recommended)
  • PyTorch 2.11 or higher
  • rustworkx 0.17.1 or higher

Basic Installation

uv pip install frontier-ai-gmas

Using pip

pip install frontier-ai-gmas

Core dependencies include:

  • rustworkx (graph operations)
  • pydantic (data validation)
  • torch (tensor operations)
  • loguru (logging)
  • openai (LLM client)

Optional Extras

uv pip install frontier-ai-gmas[web-search]   # DuckDuckGo
uv pip install frontier-ai-gmas[web-fast]     # Fast HTML parsing
uv pip install frontier-ai-gmas[selenium]     # Browser automation

Machine Learning

uv pip install frontier-ai-gmas[embeddings]   # sentence-transformers
uv pip install frontier-ai-gmas[pyg]          # PyTorch Geometric

Visualization

uv pip install frontier-ai-gmas[viz]          # graphviz, matplotlib

All Extras

uv pip install frontier-ai-gmas[all]

Development Installation

Clone and install with uv:

git clone https://github.com/frontier-ai-next/gmas.git
cd gmas
uv sync

Install pre-commit hooks:

uv run prek install

Verify Installation

from gmas.core import AgentProfile
from gmas.builder import build_property_graph

agents = [AgentProfile(agent_id="test", display_name="Test")]
graph = build_property_graph(agents, query="Test")
print(f"Success! Graph has {graph.num_nodes} nodes")