{"id":45572519,"url":"https://github.com/agentic-layer/agent-runtime-operator","last_synced_at":"2026-04-24T13:01:15.249Z","repository":{"id":307466635,"uuid":"1029600162","full_name":"agentic-layer/agent-runtime-operator","owner":"agentic-layer","description":"A Kubernetes operator for the agentic layer agent runtime component.","archived":false,"fork":false,"pushed_at":"2026-04-20T08:15:42.000Z","size":642,"stargazers_count":7,"open_issues_count":17,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-20T09:35:58.729Z","etag":null,"topics":["agent","agentic-ai","kubernetes","microservice","operator","operator-sdk"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agentic-layer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-31T09:34:53.000Z","updated_at":"2026-04-20T08:15:44.000Z","dependencies_parsed_at":"2025-07-31T13:28:10.694Z","dependency_job_id":"8a0f725e-8c5e-4dac-a7ed-2d22f11d17e2","html_url":"https://github.com/agentic-layer/agent-runtime-operator","commit_stats":null,"previous_names":["agentic-layer/agent-runtime-operator"],"tags_count":55,"template":false,"template_full_name":null,"purl":"pkg:github/agentic-layer/agent-runtime-operator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic-layer%2Fagent-runtime-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic-layer%2Fagent-runtime-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic-layer%2Fagent-runtime-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic-layer%2Fagent-runtime-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agentic-layer","download_url":"https://codeload.github.com/agentic-layer/agent-runtime-operator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentic-layer%2Fagent-runtime-operator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32224413,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T10:26:35.452Z","status":"ssl_error","status_checked_at":"2026-04-24T10:25:27.643Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentic-ai","kubernetes","microservice","operator","operator-sdk"],"created_at":"2026-02-23T08:24:35.295Z","updated_at":"2026-04-24T13:01:15.157Z","avatar_url":"https://github.com/agentic-layer.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Agent Runtime Operator\n\nThe Agent Runtime Operator is a Kubernetes operator that provides a unified, framework-agnostic way to deploy and manage agentic workloads on Kubernetes. It uses Custom Resource Definitions (CRDs) to abstract away framework-specific configurations, simplifying the management of components like wiring of agents with a observability stack or model routers.\n\nThe operator is built with the [Operator SDK](https://sdk.operatorframework.io/docs/) framework. Make sure to be familiar with the Operator SDK concepts when working with this project.\n\n## Getting Started\n\nGet started with the Agent Runtime Operator by following our comprehensive guides:\n\n- **[Install the Agent Runtime Operator](https://docs.agentic-layer.ai/agent-runtime-operator/agent-runtime/how-to-guide.html)** - Set up the operator on your Kubernetes cluster\n- **[Create your first Agent](https://docs.agentic-layer.ai/agent-runtime-operator/agents/how-to-guide.html)** - Deploy template-based and custom agents\n\n## Development\n\n### Prerequisites\n\nBefore contributing to this project, ensure you have the following tools installed:\n\n* **Go**: version 1.26.0 or higher\n* **Docker**: version 20.10+ (or a compatible alternative like Podman)\n* **kubectl**: The Kubernetes command-line tool\n* **kind**: For running Kubernetes locally in Docker\n* **make**: The build automation tool\n* **Git**: For version control\n\n### Local Environment\n\nSet up your local Kubernetes environment.\nYou can use any Kubernetes cluster. Kind is used for E2E tests and is used exemplarily here for local development.\n\n```shell\n# Create a local Kubernetes cluster (or use an existing one)\nkind create cluster\n```\n\nInstall cert-manager in the cluster, as it is required for webhook certificate management:\n```shell\n# Install cert-manager\nkubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.3.1/cert-manager.yaml\n\n# Wait for cert-manager to be ready\nkubectl wait --for=condition=ready pod -l app.kubernetes.io/name=cert-manager -n cert-manager --timeout=60s\n```\n\n### Build and Deploy\n\nBuild and deploy the operator locally:\n\n```shell\n# Install CRDs into the cluster\nmake install\n\n# Build docker image\nmake docker-build\n\n# Load image into kind cluster (not needed if using local registry)\nmake kind-load\n\n# Deploy the operator to the cluster\nmake deploy\n```\n\n### Unit Tests, code formatting, and static analysis\n\nRun unit tests, code formatting checks, and static analysis whenever you make changes:\n\n```shell\n# Run unit tests, code formatter and static analysis\nmake test\n```\n\n### Linting\n\nSeveral linters are configured via `golangci-lint`. Run the linter to ensure code quality:\n\n```shell\n# Run golangci-lint\nmake lint\n````\n\nYou can also auto-fix some issues:\n\n```shell\n# Auto-fix linting issues\nmake lint-fix\n```\n\n### End-to-End Tests\n\nThe E2E tests automatically create an isolated Kind cluster, deploy the operator and run e2e tests.\nTest cluster is kept after execution for faster reruns, so you may need to clean it up manually.\n\n```shell\n# Run complete E2E test suite\nmake test-e2e\n```\n\n```shell\n# Clean up test cluster\nmake cleanup-test-e2e\n```\n\n**E2E Test Features:**\n- Operator deployment verification\n- CRD installation testing\n- Webhook functionality testing\n- Metrics endpoint validation\n- Certificate management verification\n\n\n### Create or Update API and Webhooks\n\nThe operator-sdk CLI can be used to create or update APIs and webhooks.\nThis is the preferred way to add new APIs and webhooks to the operator.\nIf the operator-sdk CLI is updated, you may need to re-run these commands to update the generated code.\n\n```shell\n# Create API for Agent CRD\noperator-sdk create api --group runtime --version v1alpha1 --kind Agent\n\n# Create webhook for Agent CRD\noperator-sdk create webhook --group runtime --version v1alpha1 --kind Agent --defaulting --programmatic-validation\n```\n\n## Contribution\n\nSee [Contribution Guide](https://github.com/agentic-layer/agent-runtime-operator?tab=contributing-ov-file) for details on contribution, and the process for submitting pull requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentic-layer%2Fagent-runtime-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagentic-layer%2Fagent-runtime-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentic-layer%2Fagent-runtime-operator/lists"}