{"id":18798955,"url":"https://github.com/cncf/llm-starter-pack","last_synced_at":"2025-05-07T15:46:11.062Z","repository":{"id":205888724,"uuid":"712145025","full_name":"cncf/llm-starter-pack","owner":"cncf","description":"🤖 Get started with LLMs on your kind cluster, today! ","archived":false,"fork":false,"pushed_at":"2024-04-15T07:08:33.000Z","size":141,"stargazers_count":168,"open_issues_count":1,"forks_count":23,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-05-06T18:13:32.676Z","etag":null,"topics":["cloudnative","genai","kubernetes"],"latest_commit_sha":null,"homepage":"","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/cncf.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}},"created_at":"2023-10-30T22:07:50.000Z","updated_at":"2025-04-28T04:07:11.000Z","dependencies_parsed_at":"2023-12-19T05:05:56.729Z","dependency_job_id":"f4d7b494-3248-438f-a648-fcaa7efe919e","html_url":"https://github.com/cncf/llm-starter-pack","commit_stats":null,"previous_names":["cncf/llm-starter-pack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cncf%2Fllm-starter-pack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cncf%2Fllm-starter-pack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cncf%2Fllm-starter-pack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cncf%2Fllm-starter-pack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cncf","download_url":"https://codeload.github.com/cncf/llm-starter-pack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252908945,"owners_count":21823523,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cloudnative","genai","kubernetes"],"created_at":"2024-11-07T22:13:33.882Z","updated_at":"2025-05-07T15:46:11.022Z","avatar_url":"https://github.com/cncf.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A Cloud Native LLM Starter Pack\n\n## Prerequisites\n\n- [Docker](https://docs.docker.com/install/)\n- [kind](https://kind.sigs.k8s.io/)\n  - kind is \"Kubernetes in Docker,\" used by the Kubernetes project to help test features and run integration tests. It turns out it's a handy way for anyone to spin up a cluster quickly. Big thank you to @bentheelder for developing it 👏🏼 👏🏼\n- [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)\n  - kubectl is how you interact with k8s using the command line. This allows you to become a k8s whisperer :-)\n\n## Startup\n\nWe have crafted a few scripts to make this demo run as quickly as possible on your machine once you've installed the prerequisites.\n\nThis script will:\n\n- Create a kind cluster\n- Apply the Kubernetes manifests we need for our LLM chatbot demo\n- Use port-forwarding to help us access our service in the browser so we can ask our LLM questions\n\n\u003e **Note:** After applying the Kubernetes manifests, our cluster will take roughly 3-4 minutes to download the images, initialize the LLM and start the applications. You can monitor the status of the pods by running `kubectl get pods`\n\n```sh\n./startup.sh\n```\n\n## Demo\n\nNext, we can install the demo app that uses the LLM.\n\n```sh\n./demo.sh\n```\n\nIf you want to remove or tear down just the demo app, you can run \n\n```sh\n./teardown.sh\n```\n\n## Shutdown\n\nTo shut down the demo, run the following command, which will:\n\n- Remove the Kubernetes manifests\n- Remove the port-forwarding\n- Delete the kind cluster\n\n```sh\n./shutdown.sh\n```\n\n## Operating System Information\n\nThis demo has been tested on the following operating systems and will work if you have the prerequisites installed.\n\n- macOS\n- Linux\n- Windows\n\n## Verification\n\nThese images are signed with sigstore's [cosign](https://docs.sigstore.dev/cosign/overview/). You can verify the signature by downloading the `cosign.pub` key from this repo and running the following command:\n\n```bash\ncosign verify --key cosign.pub ghcr.io/cncf/llm-starter-pack:latest\n```\n\nIf you're forking this repo you should [read the docs](https://docs.github.com/en/actions/security-guides/encrypted-secrets) on keeping secrets in github. You need to [generate a new key-pair](https://docs.sigstore.dev/cosign/overview/) with `cosign`. The public key can be in your public repo (your users need it to check the signatures), and you can paste the private key in Settings -\u003e Secrets -\u003e Actions.\n\n## Acknowledgements\n\nWe'd like to thank Docker for sharing their GenAI Stack demo with us. We've used their demo as a starting point for this demo. You can find their demo [here](https://www.docker.com/blog/introducing-a-new-genai-stack/).\n\nWe'd also like to thank Weaveworks for their Weaveworks Scope project which we've used to help visualize our Kubernetes cluster. You can find their project [here](https://www.weave.works/oss/scope/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcncf%2Fllm-starter-pack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcncf%2Fllm-starter-pack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcncf%2Fllm-starter-pack/lists"}