{"id":26648982,"url":"https://github.com/vlttnv/allseer","last_synced_at":"2025-03-25T00:47:34.170Z","repository":{"id":281915066,"uuid":"946671772","full_name":"vlttnv/allseer","owner":"vlttnv","description":"A read-only, AI-powered diagnostics assistant for Kubernetes.","archived":false,"fork":false,"pushed_at":"2025-03-21T18:53:54.000Z","size":87,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-21T19:45:52.683Z","etag":null,"topics":["ai","devops","kubernetes","troubleshooting"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vlttnv.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":"2025-03-11T13:56:32.000Z","updated_at":"2025-03-21T18:54:20.000Z","dependencies_parsed_at":"2025-03-11T20:43:42.901Z","dependency_job_id":null,"html_url":"https://github.com/vlttnv/allseer","commit_stats":null,"previous_names":["vlttnv/allseer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlttnv%2Fallseer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlttnv%2Fallseer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlttnv%2Fallseer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vlttnv%2Fallseer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vlttnv","download_url":"https://codeload.github.com/vlttnv/allseer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245377954,"owners_count":20605375,"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":["ai","devops","kubernetes","troubleshooting"],"created_at":"2025-03-25T00:47:33.714Z","updated_at":"2025-03-25T00:47:34.152Z","avatar_url":"https://github.com/vlttnv.png","language":"Python","readme":"\u003cdiv style=\"text-align: center;\"\u003e\n  \u003cimg src=\"./assets/logo.svg\" alt=\"Allseer Logo\" width=\"400\" height=\"400\" /\u003e\n\u003c/div\u003e\n\n# Allseer\nAllseer is read-only, AI-powered diagnostics assistant for Kubernetes that helps DevOps and SRE engineers troubleshoot issues, surface insights, and save time by analyzing cluster data and connecting the dots across resources.\n\n## Installation\n\n### Prerequisites\n\n- [k8s-mpc](https://github.com/vlttnv/k8s-mcp) - cloned locally\n- Python 3.8+\n- Access to a Kubernetes cluster (via kubeconfig or in-cluster configuration)\n- Required Python packages (see `dependencies` in `pyproject.toml`)\n- uv - https://github.com/astral-sh/uv\n\n```bash\n# To install uv\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n```bash\n# Clone the repository\ngit clone git@github.com:vlttnv/allseer.git\ncd allseer\n\n# Install dependencies\nuv venv\nsource .venv/bin/activate\nuv sync\n```\n\nCurrently only Claude is supported.\nExport your Anthropic API key as an env variable like so:\n\n```bash\nexport ANTHROPIC_API_KEY=\"YOUR_KEY\"\n```\n\n## Configuration\n\nThe application automatically tries two methods to connect to your Kubernetes cluster:\n\n1. **Kubeconfig File**: Uses your local kubeconfig file (typically located at `~/.kube/config`)\n2. **In-Cluster Configuration**: If running inside a Kubernetes pod, uses the service account token\n\nNo additional configuration is required if your kubeconfig is properly set up or if you're running inside a cluster with appropriate RBAC permissions.\n\n## Usage\n\n### Examples\nHere are some useful example prompts you can ask Claude about your Kubernetes cluster and its resources:\n\n#### General Cluster Status\n- \"What's the overall health of my cluster?\"\n- \"Show me all namespaces in my cluster\"\n- \"What nodes are available in my cluster and what's their status?\"\n- \"How is resource utilization across my nodes?\"\n\n#### Pods and Deployments\n- \"List all pods in the production namespace\"\n- \"Are there any pods in CrashLoopBackOff state?\"\n- \"Show me pods with high restart counts\"\n- \"List all deployments across all namespaces\"\n- \"What deployments are failing to progress?\"\n\n#### Debugging Issues\n- \"Why is my pod in the staging namespace failing?\"\n- \"Get the YAML configuration for the service in the production namespace\"\n- \"Show me recent events in the default namespace\"\n- \"Are there any pods stuck in Pending state?\"\n- \"What's causing ImagePullBackOff errors in my cluster?\"\n\n#### Resource Management\n- \"Show me the resource consumption of nodes in my cluster\"\n- \"Are there any orphaned resources I should clean up?\"\n- \"List all services in the production namespace\"\n- \"Compare resource requests between staging and production\"\n\n#### Specific Resource Inspection\n- \"Show me the config for the coredns deployment in kube-system\"\n- \"Get details of the reverse-proxy service in staging\"\n- \"What containers are running in the pod xyz?\"\n- \"Show me the logs for the failing pod\"\n\n## API Reference\nThe [k8s-mpc](https://github.com/vlttnv/k8s-mcp) server exposes a set of tools. For a full list check out the project's README or source code.\n\n## License\n\n[GNU GPLv3 License](LICENSE)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvlttnv%2Fallseer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvlttnv%2Fallseer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvlttnv%2Fallseer/lists"}