{"id":48227449,"url":"https://github.com/igor-olikh/adk-installation","last_synced_at":"2026-04-04T19:24:35.624Z","repository":{"id":299774812,"uuid":"1004134518","full_name":"igor-olikh/adk-installation","owner":"igor-olikh","description":"IBM watsonx Orchestrate Agent Development Kit (ADK) Installation Guides","archived":false,"fork":false,"pushed_at":"2025-07-08T08:17:52.000Z","size":175,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-08T09:31:20.771Z","etag":null,"topics":["adk","agents","ibm","orchestrate","watsonx"],"latest_commit_sha":null,"homepage":"https://developer.watson-orchestrate.ibm.com/","language":null,"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/igor-olikh.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-18T07:03:59.000Z","updated_at":"2025-07-08T08:17:55.000Z","dependencies_parsed_at":"2025-07-08T09:25:02.282Z","dependency_job_id":"798e666b-c204-4422-95ad-7e7cff9dee62","html_url":"https://github.com/igor-olikh/adk-installation","commit_stats":null,"previous_names":["igor-olikh/adk-installation"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/igor-olikh/adk-installation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igor-olikh%2Fadk-installation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igor-olikh%2Fadk-installation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igor-olikh%2Fadk-installation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igor-olikh%2Fadk-installation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igor-olikh","download_url":"https://codeload.github.com/igor-olikh/adk-installation/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igor-olikh%2Fadk-installation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31410431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","agents","ibm","orchestrate","watsonx"],"created_at":"2026-04-04T19:24:34.794Z","updated_at":"2026-04-04T19:24:35.598Z","avatar_url":"https://github.com/igor-olikh.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# IBM watsonx Orchestrate Agent Development Kit (ADK) Installation Guides\n\nThis repository contains comprehensive installation guides for the IBM watsonx Orchestrate Agent Development Kit (ADK) across different operating systems.\n\n## Overview\n\nThe IBM watsonx Orchestrate Agent Development Kit (ADK) is a powerful set of tools designed to simplify the process of building and deploying agents using IBM watsonx Orchestrate. These guides provide step-by-step instructions for setting up the development environment on various platforms.\n\n## What's Included\n\n- **Windows Installation Guide** - Complete setup instructions for Windows users using WSL\n- **macOS Installation Guide** - Complete setup instructions for macOS users using Homebrew\n\n## Quick Start\n\n### Windows Users\n1. Follow the [Windows Installation Guide](windows.md)\n2. Install WSL 2 and Ubuntu\n3. Set up your watsonx.ai project and deployment space\n4. Install the ADK using pip\n\n### macOS Users  \n1. Follow the [macOS Installation Guide](macos.md)\n2. Install Homebrew and Python 3.12\n3. Set up your watsonx.ai project and deployment space\n4. Install the ADK using pip\n\n## Key Features\n\n- **Cross-platform Support** - Installation guides for Windows and macOS\n- **Step-by-step Instructions** - Detailed, easy-to-follow setup procedures with 8 comprehensive steps\n- **Self-contained Guides** - Complete instructions without heavy reliance on external resources\n- **Comprehensive Verification** - Built-in testing and verification procedures\n- **Platform-specific Troubleshooting** - Common issues and solutions for each platform\n- **Professional Documentation** - Consistent formatting and clear organization\n\n## Installation Process\n\nBoth guides follow a consistent 8-step installation process:\n\n1. **System Dependencies** - Install platform-specific tools (WSL/Homebrew)\n2. **Python Setup** - Install and configure Python 3.12\n3. **IBM Cloud Setup** - Configure watsonx.ai project and deployment space\n4. **Docker Installation** - Set up container runtime (Rancher Desktop)\n5. **Entitlement Key** - Obtain required access credentials\n6. **Environment Configuration** - Create and configure `.env` file\n7. **ADK Installation** - Install the orchestrate package\n8. **Verification \u0026 Testing** - Verify installation and create first agent\n\n## Getting Help\n\nIf you encounter issues during installation:\n\n1. Check the [Official Troubleshooting Guide](https://developer.watson-orchestrate.ibm.com/release/troubleshooting)\n2. Review the troubleshooting section in your platform's guide\n3. Ensure all prerequisites are properly installed\n4. Verify your IBM Cloud account has the necessary permissions\n\n## Resources\n\n- [IBM watsonx Orchestrate Documentation](https://developer.watson-orchestrate.ibm.com/)\n- [watsonx.ai Platform](https://dataplatform.cloud.ibm.com/wx/home?context=wx)\n- [IBM Cloud Documentation](https://cloud.ibm.com/docs)\n- [WSL Documentation](https://learn.microsoft.com/en-us/windows/wsl/) (Windows users)\n- [Homebrew Documentation](https://brew.sh/) (macOS users)\n- [Rancher Desktop](https://rancherdesktop.io/) (Docker runtime)\n\n## Contributing\n\nThis project welcomes contributions! If you'd like to:\n\n- Add missing installation guides (Linux)\n- Improve existing guides\n- Fix errors or add clarifications\n- Suggest enhancements\n\nPlease feel free to submit a pull request or open an issue.\n\n## License\n\nPlease refer to IBM's licensing terms for usage rights.\n\n---\n\n**Note**: These guides are designed for the latest version of the IBM watsonx Orchestrate Agent Development Kit. Always refer to the [official documentation](https://developer.watson-orchestrate.ibm.com/) for the most up-to-date information. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figor-olikh%2Fadk-installation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figor-olikh%2Fadk-installation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figor-olikh%2Fadk-installation/lists"}