Examples

Examples Catalog

Thirteen runnable example projects live in examples/, plus a shared/ helper module. Each is self-contained and uses the public SDK surfaces only. Hosted examples default to https://api.algenta.ai; under ALGENTA_DEPLOYMENT_MODE=self_hosted / air_gapped they must point at your own engine and fail closed (that behavior is exactly what shared/ provides).

SDK & runtime

Example	What it shows
mojo-quickstart	Call the signed native Mojo runtime directly from a Mojo program over its Unix-socket wire protocol — pixi run demo. Walkthrough: Mojo Quickstart.
local-runtime	Two local paths: pure-local algenta.Runtime (no API key) and hosted control plane + local execution with device license and offline history (de login, de runtime start).
google-colab	Notebook running live contract discovery, low-token governed dataset discovery, exact queries, and probabilistic simulations.

Agent & capability plane

Example	What it shows
capability-plane	Checked-in request artifacts for the unified capability plane: providers, bindings, discovery, routing, execution, outcome recording.
langgraph	LangGraph agents: a capability router over the capability plane, plus @tool-wrapped simulation and governed data/query tools.
multi-hop	Multi-hop query surfaces — POST /v1/data/connect and chained governed queries across sources.

MCP & copilot hosts

Example	What it shows
claude-desktop	Algenta from Claude Desktop, Codex, and other MCP clients against the remote MCP endpoint (/mcp).
chatgpt-actions	The hosted OpenAPI contract wired into ChatGPT Actions.
azure-ai-studio	Algenta from Azure AI Foundry / Studio copilots, prompt flows, and assistant-style agents.

Automation platforms

Example	What it shows
n8n	Algenta from n8n with HTTP Request nodes or MCP-aware AI flows.
make	Make (Integromat) scenarios calling the data, query, and simulation surfaces via the HTTP module.
zapier	Zapier Zaps via the Webhooks by Zapier action.
power-automate	A Power Automate custom connector for Microsoft flows.

Shared helper

examples/shared/ is not an example but the privacy-profile helper every example uses: it resolves the API base URL and key from ALGENTA_* env vars (legacy DE_* accepted), defaults to the hosted URL only when the active deployment profile allows it, and fails closed for self_hosted / air_gapped.

Looking for framework integrations?

LangChain, LlamaIndex, pydantic-ai, Haystack, LiteLLM, Microsoft Agent Framework, Ray Serve, vLLM, Vercel AI SDK, and n8n nodes live in the companion repo thyn-ai/algenta-integrations — each with its own runnable quickstart against a local stub server.