Developer guide

Use a disposable Arch Linux host for the self-hosted Alpha installer, or set up the source tree with Python 3.12 and Docker. The installer and source setup both create the local daemon and its permissioned control socket.

Follow the self-hosted install guide or the source setup instructions. Do not expose the local control plane to a network.

The preferred transport is /run/yantra-control/control.sock. It authorizes clients through Unix permissions. Loopback HTTP at 127.0.0.1:50000 is available only for local clients that cannot use the socket and requires YANTRA_CONTROL_TOKEN.

Read-only health and state calls are available alongside instruction injection. An injected instruction is not authority to execute: the daemon still validates payloads, chooses a typed route, applies confirmation gates, and records the outcome.

The @yantraos/sdk Node package is the supported client for local applications. It defaults to the Unix socket and deliberately cannot connect to remote hosts or browser clients.

npm install @yantraos/sdk

const { YantraClient } = require("@yantraos/sdk");
const yantra = new YantraClient();
const health = await yantra.health();

See the SDK reference for API details and error handling.

Community Edition contributions may change the local engine, sandbox broker, desktop bridge, installer, and public documentation. Managed hosted-runtime code, tenant data, billing, credentials, and managed-service endpoints are outside this repository.

Review the open-core boundary, open a GitHub issue for proposals, and use pull requests for changes that fit the public scope.