Harmony Bench – Humanitarian API

Purpose

The Harmony Bench is a dedicated, rate‑limited API providing free access to the Vedic Planetary Transformers for humanitarian and community‑led problem‑solving.

It is designed for:

Non‑governmental organisations (NGOs)
Crisis & disaster‑response teams
Mutual‑aid and community groups
Public‑health coordination
Environmental & conservation projects
Any non‑profit, non‑commercial use that serves collective good.

No tracking, no monetisation, no borders. First‑come, first‑served; scaled via volunteer compute.

Access

To use the Harmony Bench, you need an API key. Keys are free and granted upon request.

Beta Phase: During initial launch, API keys are issued manually. Contact us via GitHub issues or email (see below) with a brief description of your use case.

Each key provides:

10,000 requests per day (vs 1,000 for public portal)
Priority queue during emergency situations
Optional extended limits for large‑scale operations
Basic usage analytics (optional, anonymised)

To request a key, email harmony@spectralorchestra.com (or open a GitHub issue) with:

Organisation name & mission
Primary use case (e.g., “refugee‑camp logistics optimisation”)
Estimated daily request volume
Contact email

API Endpoint

The Harmony Bench endpoint is:

POST https://workshop.spectralorchestra.com/api/v1/harmony/solve

Required header:

X-Harmony-API-Key: your_api_key_here

Request body (JSON) is identical to the public /api/v1/solve endpoint.

Example: Disaster‑Relief Logistics

Optimising delivery routes for emergency supplies (TSP):

{
  "problem_type": "tsp",
  "data": {
    "points": [
      [0, 0],   # warehouse
      [12, 5],  # clinic A
      [3, 18],  # clinic B
      [20, 8],  # shelter C
      [7, 22]   # shelter D
    ]
  }
}

Response:

{
  "problem_type": "tsp",
  "poetic_name": "Venusian Tour Loom",
  "planet": "♀ Venus",
  "via_harmony_bench": true,
  "tour": [0, 2, 4, 1, 3, 0],
  "length": 67.32,
  "stats": { "time_ms": 104, "iterations": 42 }
}

Principles

1. No patents, no borders, only Unity. The technology is free (MIT). The API is free. There will never be a paid tier.

2. Equal footing. A small community group receives the same rate limit as a large international NGO.

3. Transparency. All code is public. All rate‑limit policies are documented. There are no hidden restrictions.

4. Volunteer‑powered. The infrastructure runs on donated compute. If you have spare capacity, you can host a node.

5. Respect for context. We do not store or analyse your problem data beyond immediate solving. No logs are kept beyond aggregate usage counts.