{"id":34875097,"url":"https://github.com/botpress/adk","last_synced_at":"2026-05-29T23:04:24.886Z","repository":{"id":320061855,"uuid":"1080620390","full_name":"botpress/adk","owner":"botpress","description":"Botpress ADK","archived":false,"fork":false,"pushed_at":"2026-05-20T20:01:08.000Z","size":163124,"stargazers_count":24,"open_issues_count":2,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-20T23:50:29.371Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://adk-demo-deep-research.botpress.sh","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/botpress.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-21T16:14:02.000Z","updated_at":"2026-05-11T20:12:09.000Z","dependencies_parsed_at":"2025-10-21T19:24:37.182Z","dependency_job_id":"74d3eca3-4263-41b3-9b1e-eef88fcdeb4b","html_url":"https://github.com/botpress/adk","commit_stats":null,"previous_names":["botpress/adk"],"tags_count":126,"template":false,"template_full_name":null,"purl":"pkg:github/botpress/adk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fadk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fadk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fadk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fadk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/botpress","download_url":"https://codeload.github.com/botpress/adk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fadk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33673664,"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-05-29T02:00:06.066Z","response_time":107,"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":[],"created_at":"2025-12-26T00:48:01.005Z","updated_at":"2026-05-29T23:04:24.856Z","avatar_url":"https://github.com/botpress.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Botpress Agent Development Kit (ADK)\n\nThe Botpress Agent Development Kit (ADK) is a high-level TypeScript framework for building AI agents on the Botpress platform.\n\n### Quick Install\n\n**macOS \u0026 Linux**\n```bash\ncurl -fsSL https://github.com/botpress/adk/releases/latest/download/install.sh | bash\n```\n\n**Windows (PowerShell)**\n```powershell\npowershell -c \"irm https://github.com/botpress/adk/releases/latest/download/install.ps1 | iex\"\n```\n\n### Manual Installation\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand manual install instructions\u003c/summary\u003e\n\n**macOS (Apple Silicon)**\n```bash\ncurl -fsSL https://github.com/botpress/adk/releases/download/v1.4.2/adk-darwin-arm64.tar.gz | tar -xz\nsudo mv adk-darwin-arm64 /usr/local/bin/adk\nadk --version\n```\n\n**macOS (Intel)**\n```bash\ncurl -fsSL https://github.com/botpress/adk/releases/download/v1.4.2/adk-darwin-x64.tar.gz | tar -xz\nsudo mv adk-darwin-x64 /usr/local/bin/adk\nadk --version\n```\n\n**Linux (x64)**\n```bash\ncurl -fsSL https://github.com/botpress/adk/releases/download/v1.4.2/adk-linux-x64.tar.gz | tar -xz\nsudo mv adk-linux-x64 /usr/local/bin/adk\nadk --version\n```\n\n**Windows (Manual)**\n```powershell\nInvoke-WebRequest -Uri \"https://github.com/botpress/adk/releases/download/v1.4.2/adk-windows-x64.zip\" -OutFile \"adk.zip\"\nExpand-Archive -Path \"adk.zip\" -DestinationPath \"$env:LOCALAPPDATA\\Programs\\adk\"\n$env:PATH += \";$env:LOCALAPPDATA\\Programs\\adk\"\n[Environment]::SetEnvironmentVariable(\"PATH\", $env:PATH, \"User\")\nadk --version\n```\n\n\u003c/details\u003e\n\n### Getting Started\n\n```bash\n# 1. Install ADK\ncurl -fsSL https://github.com/botpress/adk/releases/latest/download/install.sh | bash\n\n# 2. Create a new agent\nadk init my-agent\n\n# 3. Select \"Blank\" template\n# 4. Choose your package manager: npm / pnpm / bun\n\n# 5. Install dependencies\n# (choose one based on your package manager)\nnpm install\n# or\npnpm install\n# or\nbun install\n\n# 6. Install required Botpress packages\nnpm i @botpress/sdk@4.17.1 @botpress/runtime@1.3.4\n# or\npnpm add @botpress/sdk@4.17.1 @botpress/runtime@1.3.4\n# or\nbun add @botpress/sdk@4.17.1 @botpress/runtime@1.3.4\n\n# 7. Install the Botpress CLI globally\nnpm install -g @botpress/cli@4.15.0\n# (use sudo if required)\n\n# 8. Log in and link your agent\nadk login\nadk link\n# Select \"Create new Bot\" when prompted\n\n# 9. Add the chat capability\nadk install chat\n\n# 10. Update your agent files\n# - Edit conversation/index.ts\n# - Edit agent.config.ts\n\n# 11. Start local development\nadk dev\n\n12. (In a new terminal) Chat with your agent\nadk chat\n```\n\n### Documentation\n\n- [ADK Documentation](https://botpress.com/docs/for-developers/adk/overview)\n- [Botpress Platform](https://botpress.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotpress%2Fadk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbotpress%2Fadk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotpress%2Fadk/lists"}