{"id":50871278,"url":"https://github.com/paradigmxyz/centaur-acme","last_synced_at":"2026-06-15T05:30:31.094Z","repository":{"id":359317699,"uuid":"1243037216","full_name":"paradigmxyz/centaur-acme","owner":"paradigmxyz","description":"Template organization overlay for extending Centaur with tools, workflows, skills, and sandbox guidance.","archived":false,"fork":false,"pushed_at":"2026-06-02T04:05:13.000Z","size":15,"stargazers_count":11,"open_issues_count":0,"forks_count":20,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T05:21:44.367Z","etag":null,"topics":["agents","ai","centaur","infrastructure","overlay","template"],"latest_commit_sha":null,"homepage":"https://centaur.run/extend/acme-example","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paradigmxyz.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":"2026-05-19T01:56:38.000Z","updated_at":"2026-06-02T04:05:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paradigmxyz/centaur-acme","commit_stats":null,"previous_names":["paradigmxyz/centaur-acme"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/paradigmxyz/centaur-acme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Fcentaur-acme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Fcentaur-acme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Fcentaur-acme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Fcentaur-acme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paradigmxyz","download_url":"https://codeload.github.com/paradigmxyz/centaur-acme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradigmxyz%2Fcentaur-acme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34349925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agents","ai","centaur","infrastructure","overlay","template"],"created_at":"2026-06-15T05:30:30.121Z","updated_at":"2026-06-15T05:30:31.089Z","avatar_url":"https://github.com/paradigmxyz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1500\" height=\"500\" alt=\"Centaur banner\" src=\"https://github.com/user-attachments/assets/cc85cdb1-5a72-4eb2-ba1b-2e0a8fbbf691\" /\u003e\n\n\u003ch4 align=\"center\"\u003e\n    Example organization overlay for Centaur.\n\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n  Package your tools, workflows, skills, and sandbox guidance as a reusable\n  overlay image.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#use-this-template\"\u003eUse This Template\u003c/a\u003e •\n  \u003ca href=\"#what-you-customize\"\u003eWhat You Customize\u003c/a\u003e •\n  \u003ca href=\"#build-the-overlay-image\"\u003eBuild\u003c/a\u003e •\n  \u003ca href=\"#verify-in-a-running-deployment\"\u003eVerify\u003c/a\u003e\n\u003c/p\u003e\n\n## Overview\n\n`centaur-acme` is a public, forkable template for creating an organization\noverlay for [Centaur](https://github.com/paradigmxyz/centaur). It is\nintentionally small and free of private data. Use it as the starting point for\nshipping org-specific capabilities without forking the core platform.\n\nThe overlay image is copied into Centaur at runtime:\n\n```text\ncentaur-acme repo\n    |\n    v\noverlay image\n    |\n    +-- /app/overlay/org in the API\n    +-- /home/agent/overlay/org in sandbox pods\n```\n\n## Use This Template\n\n1. Click **Use this template** in GitHub, or fork the repo if you want to keep a\n   visible upstream relationship.\n2. Rename ACME examples to your organization or team name.\n3. Replace the toy CRM tool with one small real integration.\n4. Update the sandbox prompt and skill to match the behavior your agents should\n   follow.\n5. Build and publish the overlay image, then point your Centaur Helm values at\n   that image.\n\nKeep credentials out of this repository. Tools should request secrets through\nCentaur's secret system instead of committing values or `.env` files.\n\n## What You Customize\n\nThe template demonstrates the extension points an organization normally owns:\n\n- `tools/` for API-discovered tools\n- `workflows/` for durable workflows\n- `.agents/skills/` for sandbox-loaded skills\n- `services/sandbox/SYSTEM_PROMPT.md` for organization-specific agent guidance\n\n## Repository Map\n\n```text\n.\n├── .agents/skills/acme-support/     # sandbox skill loaded with the overlay\n├── services/sandbox/SYSTEM_PROMPT.md\n├── tools/acme_crm/                  # packaged Python CLI tool with sample data\n├── tools/acme_go/                   # minimal Go CLI tool\n├── tools/acme_rust/                 # minimal Rust CLI tool\n├── workflows/daily_acme_brief.py    # example durable workflow\n├── tests/\n└── Dockerfile                       # copies the overlay to /overlay\n```\n\n## Build the overlay image\n\n```bash\ndocker build -t ghcr.io/\u003corg\u003e/\u003coverlay-repo\u003e:local .\n```\n\nThe image copies this repository to `/overlay`. Centaur's Helm chart mounts that\npath at `/app/overlay/org` in the API and `/home/agent/overlay/org` in sandbox\npods.\n\n## Use with Helm\n\n```yaml\noverlay:\n  image:\n    repository: ghcr.io/\u003corg\u003e/\u003coverlay-repo\u003e\n    tag: sha-0000000\n    pullPolicy: IfNotPresent\n    sourcePath: /overlay\n```\n\nFor the full GitOps example, pair this repo with\n[`centaur-acme-infra`](https://github.com/paradigmxyz/centaur-acme-infra).\n\n## Included examples\n\n`tools/acme_crm` is a packaged Python CLI tool with no external credentials.\n`tools/acme_rust` and `tools/acme_go` are tiny compiled CLI examples that prove\nan overlay can ship source-built tools across the supported runtimes.\n\n`workflows/daily_acme_brief.py` is a minimal recurring workflow that asks an\nagent for a daily operating summary.\n\n`.agents/skills/acme-support/SKILL.md` is a sandbox skill that demonstrates how\nACME-specific playbooks are packaged.\n\n`services/sandbox/SYSTEM_PROMPT.md` is appended to the base sandbox prompt when\nthe overlay is mounted.\n\n## Verify in a running deployment\n\nFrom the API pod:\n\n```bash\necho \"$TOOL_DIRS\"\necho \"$WORKFLOW_DIRS\"\nls -la /app/overlay/org\n```\n\nFrom a sandbox:\n\n```bash\necho \"$CENTAUR_OVERLAY_DIR\"\nls \"$CENTAUR_OVERLAY_DIR\"\nls \"$CENTAUR_OVERLAY_DIR/.agents/skills\"\n```\n\n## Local checks\n\n```bash\nuv run pytest\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadigmxyz%2Fcentaur-acme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparadigmxyz%2Fcentaur-acme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadigmxyz%2Fcentaur-acme/lists"}