Argocd-AI-Assistant

Notifications You must be signed in to change notification settings

Fork 0

Star 1

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

88 Commits

88 Commits

.github

.github

docs

docs

examples/kind

examples/kind

src

src

.gitignore

.gitignore

.readthedocs.yaml

.readthedocs.yaml

CONTRIBUTING.md

CONTRIBUTING.md

LICENSE.md

LICENSE.md

README.md

README.md

mkdocs.yml

mkdocs.yml

package.json

package.json

tsconfig.json

tsconfig.json

webpack.config.js

webpack.config.js

yarn.lock

yarn.lock

Repository files navigation

An Argo CD UI extension that adds an Assistant tab to the resource view. Open any Kubernetes resource, ask questions about it in natural language, and the extension enriches each query with context:

Resource manifest - the live object, provided by Argo CD.

Events - fetched from the Argo CD API and attached automatically.

Logs (optional) - from a single container, via a guided flow (Pod, Deployment, StatefulSet, Job, Rollout).

Supported Backends

A single generic provider speaks the OpenAI-compatible chat completions API, so it works with any backend that does: a local inference server (e.g. Ollama), vLLM, OpenAI, Azure OpenAI, or any other OpenAI-compatible endpoint. Traffic is routed through the Argo CD Proxy Extension to avoid CORS.

Prerequisites

Argo CD >= v2.13

A running LLM backend with an OpenAI-compatible API accessible from the Argo CD server

Development

Install dependencies (requires --force due to React peer dependency quirks)

yarn install --force

Production build

yarn run build

Development build

yarn run build-dev

Release

Releases are automated: on merge to main (once CI passes), a workflow classifies the change, bumps the version, tags it, and publishes a GitHub Release with the extension tar. No manual version bumping. See Build and Package for details.

Deployment

See the Deployment Guide for step-by-step instructions on building, packaging, hosting, and installing the extension into Argo CD via the Extension Installer. It covers the Argo CD Operator, the community Helm chart, and raw manifests.

Local testing

To try the extension end to end on a throwaway kind cluster - with a built-in mock LLM, no GPU or API key required - use the harness in examples/kind/:

./examples/kind/setup.sh raw # or: helm | operator

A successful run installs Argo CD, installs this extension built from source, and verifies the full path (including a streamed proxy request) with == 8 passed, 0 failed ==. See examples/kind/README.md.

Documentation

Full documentation is in the docs/ directory and built with MkDocs Material.

Live docs: argocd-ai-assistant.readthedocs.io

Source

Source and releases: github.com/saidsef/argocd-ai-assistant.

Contributing

Pull requests welcome - see the Contribution Guide.

About

Argo CD AI Assistant - An AI-powered chatbot extension for Argo CD

Resources

Readme

License

Apache-2.0 license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks

Report repository

Releases 85

v11.0.2

Latest

Jul 12, 2026

+ 84 releases

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

TypeScript 83.6%

CSS 14.5%

JavaScript 1.9%