System Requirements
Supported Operator Hosts
- Linux
- macOS
The supported runtime path is Docker-based on both platforms.
Tooling
- Docker with Compose v2
uv- Git
Python Versions
Current package floors:
| Repo | Python |
|---|---|
xian-cli | >=3.12 |
xian-abci | >=3.12 |
xian-contracting | >=3.12 |
xian-linter | >=3.12 |
xian-py | >=3.11 |
Runtime Notes by Platform
Linux
Linux gives the cleanest runtime controls for memory and process limits, especially with Docker or Podman plus system-level supervision.
macOS
macOS is supported, but hard memory limits are most practical through Docker Desktop rather than host-native process limits. This is the current documented path for operator testing on macOS.
Recommended Validation
Before running a node:
bash
cd ~/xian/xian-stack
make validate
make smoke-cli