Aligner setup

The Aligner is a lightweight RAG node that indexes local files and serves retrieval requests from the Orchestrator. You run one Aligner per machine you want to include in your mesh.

Requirements

• Python 3.10+
• uv
• Tailscale installed and logged in

Installation

git clone https://github.com/SwayamDani/aligner
cd aligner
uv sync
source .venv/bin/activate

Running

Point the Aligner at a directory to index:

./tools/run serve -d /path/to/your/docs

With a security manifest:

./tools/run serve -d ./docs -m ./security.json

The Aligner listens on port 8000 by default.

Security manifest

A security manifest (security.json) maps files and line ranges to security levels:

{
  "rules": [
    {
      "path": "docs/internal/**",
      "level": "B"
    },
    {
      "path": "docs/public/**",
      "level": "A"
    },
    {
      "path": "src/auth.py",
      "lines": [1, 50],
      "level": "BA"
    }
  ]
}

Files not matched by any rule default to level A (lowest).

Health check

curl http://localhost:8000/health
# {"status": "ok", "indexed_chunks": 1247}