Skip to content

HexRift

Python Build License uv Ruff

HexRift is a config generator for the Conglomerate distributed proxy network. It takes a topology YAML definition and produces Xray JSON configs and HAProxy configs for every node.

Quick start

# 1. Install
uv tool install hexrift

# 2. Validate your topology
hexrift --yaml conglomerate.yaml validate

# 3. Generate share links
hexrift --yaml conglomerate.yaml share alice --cdn

  • Getting Started

    Install HexRift, write your first topology YAML, and run the full workflow in minutes.

  • CLI Reference

    Complete reference for every command and every flag.

  • Topology Schema

    Full annotated YAML reference — every field, type, default, and validation rule.

  • Architecture

    Component/Controller internals, deterministic derivation formulas, key storage format, and developer guide.