This is the public open-source repository for the Zelkor platform. Product code, Helm charts, and public documentation live here.
Zelkor's label and core advantage: The self-hosted agent runtime — bring the agent you already wrote; it can't break out, reach unauthorized data or networks, its prompts are verified, budget controlled, and it is under observation; tenants stay isolated.
charts/zelkor-platform/: Unified Helm chart for the platform. Production defaults only (no dev passwords or*.localhost).charts/zelkor-agent/: Helm chart for deploying customer agents as ClusterIP workers.profiles/: Local overlays (e.g.,values-local.yaml) for kind/dev environments.images/: Dockerfiles for first-party images (Aegra runtime, MCP, guardrails, sandbox).agents/: Platform auth handlers for tenant isolation.mcp/: Native MCP servers (thin Postgres, Qdrant library wrap).examples/: Demo applications (e.g. FinServe) and armored catalog overlays.scripts/: Install and uninstall scripts (install-production.sh,install-quickstart.sh,uninstall.sh).cli/: ThezelkorCLI source code.docs/: Public product documentation (published to the website).tests/: Env-agnostic platform integration tests.
- Gateway API Standard: Never use
ingress-nginx. All ingress and routing must use Kubernetes Gateway API (gateway.networking.k8s.io/v1) with Envoy Gateway. - No Dev Defaults in Platform: Do not bake
*.localhost,dev-key, or local passwords intocharts/zelkor-platform/values.yamlor templates. Useprofiles/values-local.yamlfor dev overrides. - Platform vs Demo Boundary: Demos (
examples/) are separate Helm charts. Do not put demo-shaped defaults or fixture tenants into the platform chart. Platform tests must pass withINSTALL_EXAMPLES=false. - Agent Deployment (Drop-In Contract): Customer agents are deployed as separate ClusterIP Deployments (
charts/zelkor-agent), not merged into the platform'saegra.graphs. Envoy routes traffic byX-Graph-IDor?graph_id=. - LLM Routing: All LLM calls route through the Envoy AI Gateway
/v1endpoint. Do not connect agents directly to providers. Add providers via Helm overlays. - No Inline Python in Helm: Do not paste application Python into ConfigMaps. App modules live in container images; config files live in
files/. - Component Versions: Pin to exact stable semver tags for third-party components. Re-baseline related pins together.
- Platform Logging: All processes must log to stdout in JSON format at the Helm-controlled level (
ZELKOR_LOG_LEVEL). Do not log secrets or health probes at INFO. - Git Workflow: Commit to feature branches (
feat/,fix/,chore/) and open a PR. Never commit directly tomain. Use Conventional Commits. - Documentation: Write user-friendly, progressive-disclosure documentation in
docs/. No internal jargon. Provide complete, copy-pasteable commands.
- Platform Install: See
docs/agent-install.mdfor instructions on runninginstall-production.shorinstall-quickstart.sh. - Agent Deploy: See
docs/agent-deploy.mdfor instructions on deploying agents viacharts/zelkor-agentor thezelkorCLI.