{"id":32523944,"url":"https://github.com/caron14/adk-samples","last_synced_at":"2026-07-03T22:32:06.158Z","repository":{"id":299042073,"uuid":"1001885748","full_name":"caron14/adk-samples","owner":"caron14","description":"Hands on Agent Development Kit(ADK)","archived":false,"fork":false,"pushed_at":"2025-06-24T13:07:36.000Z","size":120,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-28T08:39:09.212Z","etag":null,"topics":["adk","adk-python","adk-sample"],"latest_commit_sha":null,"homepage":"","language":"Python","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/caron14.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-06-14T08:41:32.000Z","updated_at":"2025-08-22T16:02:42.000Z","dependencies_parsed_at":"2025-06-14T10:28:31.245Z","dependency_job_id":"22ca6461-ce60-46f0-8c5b-54c73fbfdc39","html_url":"https://github.com/caron14/adk-samples","commit_stats":null,"previous_names":["caron14/adk-samples"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/caron14/adk-samples","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caron14%2Fadk-samples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caron14%2Fadk-samples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caron14%2Fadk-samples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caron14%2Fadk-samples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caron14","download_url":"https://codeload.github.com/caron14/adk-samples/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caron14%2Fadk-samples/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35104113,"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-07-03T02:00:05.635Z","response_time":110,"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":["adk","adk-python","adk-sample"],"created_at":"2025-10-28T08:31:32.515Z","updated_at":"2026-07-03T22:32:06.152Z","avatar_url":"https://github.com/caron14.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ADK Sample Agents Repository\n\nThis repository provides a collection of sample AI agents and reference implementations for both Python and Java. It is designed to help developers understand, customize, and deploy various agent-based solutions using the Agent Development Kit (ADK). Each agent is organized as an independent project with its own documentation, code, and deployment resources. Common utilities and shared modules are also included for reuse and extension.\n\n## Getting Started\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/caron14/adk-samples.git\n```\n\n2. Navigate to the project directory:\n```bash\ncd adk-samples\n```\n\n3. Install the required dependencies:\n```bash\nuv sync\n```\n\nThe dependency for development can be installed:\n```bash\nuv sync --extra dev\n```\n\n4. Set up the environment variables:\n   Create a `.env` file in the root directory and add the following variables:\n   ```env\n   GOOGLE_GENAI_USE_VERTEXAI=TRUE\n   GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID\n   GOOGLE_CLOUD_LOCATION=LOCATION\n   ```\n5. If you are using Google Cloud Vertex AI, ensure you have the necessary permissions and have set up your Google Cloud project as described in the [Set up the model](#set-up-the-model) section below.\n   If you are using a different model, adjust the environment variables accordingly.\n   For example, if you are using OpenAI, you might need to set `OPENAI_API_KEY` and other relevant variables.\n   ```env\n    ROOT_AGENT_MODEL='your-root-agent-model-id' # ex. 'gemini-2.0-flash-lite-001'\n    SPECIFIC_AGENT_MODEL='your-specific-agent-model-id' # ex. 'gemini-2.0-flash-lite-001'\n    ```\n6. Run the agent:\n   ```bash\n   python -m agents.\u003cagent_name\u003e\n   ```\n\n## Development Tools\npylint/balck/isort/mypy/pytest\n```bash\nuv run pylint $(git ls-files '*.py')\nuv run black .\nuv run isort .\nuv run mypy .\nuv run pytest  \n```\n\nTest the black formatter to ensure the CI pipeline will pass:\n```bash\nuv run black --check --diff .\n```\n\n# Test by Pytest\n```bash\nuv run pytest -q\n```\n\n## Reference:\n- https://google.github.io/adk-docs/\n\n**Prompting Guide by OpenAI**\n- [GPT4.1 Prompting Guide](https://media.licdn.com/dms/document/media/v2/D4E1FAQFJukaW0z5PDQ/feedshare-document-pdf-analyzed/B4EZZFAKJ_HUAY-/0/1744914403183?e=1751500800\u0026v=beta\u0026t=x5kdIh02AnRy7Uom2qAjVGT7lUree73zxJqRU7P9B3k)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaron14%2Fadk-samples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaron14%2Fadk-samples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaron14%2Fadk-samples/lists"}