LOOP

Important

Archived 2026-10-14. localLOOP is now developed in the open at MycelAI/LocalLOOP; this repository's history continues there in protocol. This repository is read-only. The lab demo now lives at https://loop.urbnia.com (API under /api/); localloop.urbnia.com and loop-api.urbnia.com redirect there.

Local Optimization with Overflow Protocol. A federated circular economy concept with shared schemas and interoperability notes.

Early-stage, low-TRL concept. No public pilots or deployments. Lab demo only.

What is here

• SPECIFICATION.md: core protocol spec.
• schemas/: JSON Schema definitions.
• examples/: sample payloads for interop.
• contexts/: JSON-LD contexts.
• profiles/: applicability profiles, including the lab-only Core-DP contract and conformance vectors.
• docs/regulatory-alignment-roadmap.md: long-horizon EU and German compatibility plan.
• rfcs/: RFCs and design notes.

Quickstart

npm ci
npm run test
npm run check:domains

Use npm run test, not bare npm test: where npm is aliased to bun, the bare form dispatches to Bun's built-in test runner instead of the validation script. With Bun as your package manager, bun install --frozen-lockfile and bun run test are the equivalents of the first two commands.

Usage notes

• Specs and schemas are draft and subject to change.
• No certified implementations exist at this time.
• Use examples/ to validate tooling and docs.
• Core-DP is a lab-only applicability profile, not a full LOOP conformance claim.

Links

• Docs hub: https://localloop.urbnia.com
• Backend API: https://loop-api.urbnia.com

Contributing

• Use rfcs/ for feedback and proposals.
• Domain policy: DOMAIN-POLICY.md. Org-wide agent/contributor context lives in the workspace-level AGENTS.md of the local-loop-io checkout (not part of this repository).