Installation

We recommend using uv for fast, reproducible installs and virtual‑env management.

Add as a project dependency

uv add hyperia

Direct install with pip or uv pip

# With uv
uv pip install hyperia

# Or with vanilla pip
pip install hyperia

---

Verify the Installation

Check that Hyperia is available and MCP wiring works:

hyperia version

Example output:

$ hyperia version

Hyperia version:      0.4.2.dev0
MCP spec version:     1.6.0
Python version:       3.12.2
Platform:             macOS-15.4-arm64
Hyperia root path:    ~/dev/hyperia

---

Migrating from the Official MCP SDK

from hyperia import Hyperia

mcp = Hyperia("My MCP Server")

---

Installing for Development / Contributions

git clone https://github.com/HyperiaProtocol/hyperia.git
cd hyperia
uv sync            # installs dev + runtime deps and creates venv

Activate the virtual environment as you normally would, then you’re ready to hack.

---

Unit Tests

Hyperia ships with a comprehensive Pytest suite. All pull requests must add or update tests and pass CI:

pytest

Pre‑Commit Hooks

We use pre‑commit for linting, formatting, and type‑checking. Hooks run automatically in CI but you can install them locally:

uv run pre-commit install   # one‑time setup

You can always run all hooks manually:

pre-commit run --all-files