{"id":50973475,"url":"https://github.com/zitro/core-discovery-template","last_synced_at":"2026-06-19T05:01:42.980Z","repository":{"id":352995230,"uuid":"1217535129","full_name":"zitro/core-discovery-template","owner":"zitro","description":"Template repo for new CORE Discovery customer instances. Use this template, or run: npx create-core-discovery-app \u003cname\u003e","archived":false,"fork":false,"pushed_at":"2026-05-07T18:55:37.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T20:43:12.165Z","etag":null,"topics":["core-discovery","discovery-framework","docker-compose","template"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/create-core-discovery-app","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zitro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04-22T01:34:42.000Z","updated_at":"2026-05-07T18:57:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zitro/core-discovery-template","commit_stats":null,"previous_names":["zitro/core-discovery-template"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/zitro/core-discovery-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitro%2Fcore-discovery-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitro%2Fcore-discovery-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitro%2Fcore-discovery-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitro%2Fcore-discovery-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zitro","download_url":"https://codeload.github.com/zitro/core-discovery-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zitro%2Fcore-discovery-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34517750,"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-19T02:00:06.005Z","response_time":61,"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":["core-discovery","discovery-framework","docker-compose","template"],"created_at":"2026-06-19T05:01:37.530Z","updated_at":"2026-06-19T05:01:42.971Z","avatar_url":"https://github.com/zitro.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# core-discovery-template\n\nA **GitHub template repository** for spinning up a new CORE Discovery\ninstance. CORE Discovery is a multi-customer, multi-project framework\nfor running discovery engagements. The framework itself ships as signed\ncontainer images on GHCR -- this repo holds **only** deploy\nconfiguration, project content, and customizations.\n\n## Two ways to start\n\n### 1. Click \"Use this template\" on GitHub\n\nBest for one-off setup. Click the green **Use this template** button at\nthe top of this repo, name your new repo (e.g. `my-core`), then:\n\n```bash\ngit clone https://github.com/\u003cyou\u003e/my-core.git\ncd my-core\ncp .env.example .env\n# edit .env to pick LLM / storage / auth providers and set SECRET_KEY\ndocker compose pull\ndocker compose up -d\n```\n\nOpen http://localhost:3000.\n\n### 2. Use the CLI (recommended for new instances)\n\nThe CLI fills in the instance name, picks providers, and pins the right\nframework version automatically.\n\n```bash\nnpx create-core-discovery-app my-core\ncd my-core\ndocker compose up -d\n```\n\nCLI source: https://www.npmjs.com/package/create-core-discovery-app\n\n## What you get\n\n```\n.\n|-- compose.yaml          # pinned to ghcr.io/zitro/core-framework-*:\u003cversion\u003e\n|-- .env.example          # provider knobs (LLM, storage, auth, secret_key)\n|-- renovate.json         # grouped image bumps with auto-merge for patches\n|-- projects/             # per-project Markdown content (mounted read-only)\n|-- extensions/           # optional Python plugins, loaded at backend startup\n|-- config/prompts/       # custom prompt overrides\n`-- infra/                # placeholder for IaC (Bicep / Terraform / Pulumi)\n```\n\n## Adding a project\n\nDrop content into `projects/\u003cslug\u003e/`, then register it with the running\nbackend:\n\n```powershell\n$body = @{ name = \"My Project\"; slug = \"my-project\"; repo_path = \"my-project\" } |\n  ConvertTo-Json\nInvoke-RestMethod -Uri http://localhost:8000/api/projects -Method Post `\n  -ContentType \"application/json\" -Body $body\n```\n\nYou can also use the in-app **Settings -\u003e Customer** panel to attach\nGitHub repositories, local clones, or plain folders as content sources\nfor a customer. PATs for private GitHub sources are encrypted at rest\nusing the symmetric `SECRET_KEY` you set in `.env`.\n\n## Updating the framework\n\nRenovate watches the GHCR image tags pinned in `compose.yaml` and opens\nPRs when new releases ship. Patch bumps auto-merge after CI; minor and\nmajor bumps need human review.\n\n## Pointing at external content\n\n`compose.yaml` mounts `./projects` by default. If your real project\ncontent lives elsewhere (a sibling repo, a notes folder, etc.), set\n`PROJECTS_SOURCE` in your `.env` and that path will be mounted instead:\n\n```bash\n# Mount a sibling content repo:\nPROJECTS_SOURCE=../my-content-repo\n\n# Or an absolute path on the host:\nPROJECTS_SOURCE=/path/to/content\n```\n\n## Links\n\n- Framework source: https://github.com/zitro/core-framework\n- CLI scaffolder:   https://www.npmjs.com/package/create-core-discovery-app\n- Container images: https://github.com/zitro?tab=packages\u0026q=core-framework\n- Changelog:        https://github.com/zitro/core-framework/blob/master/CHANGELOG.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzitro%2Fcore-discovery-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzitro%2Fcore-discovery-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzitro%2Fcore-discovery-template/lists"}