{"id":28361485,"url":"https://github.com/igopalakrishna/devops-swarm-ai","last_synced_at":"2025-09-02T15:32:34.972Z","repository":{"id":294556790,"uuid":"987350875","full_name":"igopalakrishna/devops-swarm-ai","owner":"igopalakrishna","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-21T00:48:53.000Z","size":370,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-04T19:36:22.721Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","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/igopalakrishna.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}},"created_at":"2025-05-21T00:36:46.000Z","updated_at":"2025-05-21T00:48:56.000Z","dependencies_parsed_at":"2025-05-26T00:30:23.212Z","dependency_job_id":null,"html_url":"https://github.com/igopalakrishna/devops-swarm-ai","commit_stats":null,"previous_names":["igopalakrishna/devops-swarm-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/igopalakrishna/devops-swarm-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igopalakrishna%2Fdevops-swarm-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igopalakrishna%2Fdevops-swarm-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igopalakrishna%2Fdevops-swarm-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igopalakrishna%2Fdevops-swarm-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igopalakrishna","download_url":"https://codeload.github.com/igopalakrishna/devops-swarm-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igopalakrishna%2Fdevops-swarm-ai/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261398835,"owners_count":23152740,"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":[],"created_at":"2025-05-28T13:39:58.849Z","updated_at":"2025-09-02T15:32:34.966Z","avatar_url":"https://github.com/igopalakrishna.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# devops-swarm-ai\n\nA multi-agent system implemented with CrewAI created to support coding activities\nAgent generated with [`googleCloudPlatform/agent-starter-pack`](https://github.com/GoogleCloudPlatform/agent-starter-pack) version `0.4.2`\n\n## Project Structure\n\nThis project is organized as follows:\n\n```\ndevops-swarm-ai/\n├── app/                 # Core application code\n│   ├── agent.py         # Main agent logic\n│   ├── server.py        # FastAPI Backend server\n│   └── utils/           # Utility functions and helpers\n├── deployment/          # Infrastructure and deployment scripts\n├── notebooks/           # Jupyter notebooks for prototyping and evaluation\n├── tests/               # Unit, integration, and load tests\n├── Makefile             # Makefile for common commands\n└── pyproject.toml       # Project dependencies and configuration\n```\n\n## Requirements\n\nBefore you begin, ensure you have:\n- **uv**: Python package manager - [Install](https://docs.astral.sh/uv/getting-started/installation/)\n- **Google Cloud SDK**: For GCP services - [Install](https://cloud.google.com/sdk/docs/install)\n- **Terraform**: For infrastructure deployment - [Install](https://developer.hashicorp.com/terraform/downloads)\n- **make**: Build automation tool - [Install](https://www.gnu.org/software/make/) (pre-installed on most Unix-based systems)\n\n\n## Quick Start (Local Testing)\n\nInstall required packages and launch the local development environment:\n\n```bash\nmake install \u0026\u0026 make playground\n```\n\n## Commands\n\n| Command              | Description                                                                                 |\n| -------------------- | ------------------------------------------------------------------------------------------- |\n| `make install`       | Install all required dependencies using uv                                                  |\n| `make playground`    | Launch local development environment with backend and frontend|\n| `make backend`       | Deploy agent to Cloud Run |\n| `make local-backend`       | Deploy agent to Cloud Run |\n| `make test`          | Run unit and integration tests                                                              |\n| `make lint`          | Run code quality checks (codespell, ruff, mypy)                                             |\n| `make setup-dev-env` | Set up development environment resources using Terraform                                    |\n| `uv run jupyter lab` | Launch Jupyter notebook                                                                     |\n\nFor full command options and usage, refer to the [Makefile](Makefile).\n\n\n## Usage\n\nThis template follows a \"bring your own agent\" approach - you focus on your business logic, and the template handles everything else (UI, infrastructure, deployment, monitoring).\n\n1. **Prototype:** Build your Generative AI Agent using the intro notebooks in `notebooks/` for guidance. Use Vertex AI Evaluation to assess performance.\n2. **Integrate:** Import your agent into the app by editing `app/agent.py`.\n3. **Test:** Explore your agent functionality using the Streamlit playground with `make playground`. The playground offers features like chat history, user feedback, and various input types, and automatically reloads your agent on code changes.\n4. **Deploy:** Set up and initiate the CI/CD pipelines, customizing tests as necessary. Refer to the [deployment section](#deployment) for comprehensive instructions. For streamlined infrastructure deployment, simply run `agent-starter-pack setup-cicd`. Check out the [`agent-starter-pack setup-cicd` CLI command](https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/cli/setup_cicd.md). Currently only supporting Github.\n5. **Monitor:** Track performance and gather insights using Cloud Logging, Tracing, and the Looker Studio dashboard to iterate on your application.\n\n\n## Deployment\n\n\u003e **Note:** For a streamlined one-command deployment of the entire CI/CD pipeline and infrastructure using Terraform, you can use the [`agent-starter-pack setup-cicd` CLI command](https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/cli/setup_cicd.md). Currently only supporting Github.\n\n### Dev Environment\n\nYou can test deployment towards a Dev Environment using the following command:\n\n```bash\ngcloud config set project \u003cyour-dev-project-id\u003e\nmake backend\n```\n\n\nThe repository includes a Terraform configuration for the setup of the Dev Google Cloud project.\nSee [deployment/README.md](deployment/README.md) for instructions.\n\n### Production Deployment\n\nThe repository includes a Terraform configuration for the setup of a production Google Cloud project. Refer to [deployment/README.md](deployment/README.md) for detailed instructions on how to deploy the infrastructure and application.\n\n\n## Monitoring and Observability\n\u003e You can use [this Looker Studio dashboard](https://lookerstudio.google.com/c/reporting/fa742264-4b4b-4c56-81e6-a667dd0f853f/page/tEnnC\n) template for visualizing events being logged in BigQuery. See the \"Setup Instructions\" tab to getting started.\n\nThe application uses OpenTelemetry for comprehensive observability with all events being sent to Google Cloud Trace and Logging for monitoring and to BigQuery for long term storage.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figopalakrishna%2Fdevops-swarm-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figopalakrishna%2Fdevops-swarm-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figopalakrishna%2Fdevops-swarm-ai/lists"}