{"id":13594722,"url":"https://github.com/poshbotio/PoshBot","last_synced_at":"2025-04-09T07:33:49.379Z","repository":{"id":15365918,"uuid":"77993715","full_name":"poshbotio/PoshBot","owner":"poshbotio","description":"Powershell-based bot framework","archived":false,"fork":false,"pushed_at":"2025-04-01T15:12:25.000Z","size":5353,"stargazers_count":543,"open_issues_count":37,"forks_count":108,"subscribers_count":33,"default_branch":"master","last_synced_at":"2025-04-04T03:29:05.475Z","etag":null,"topics":["bot","bot-framework","bots","chatbot","chatbot-framework","chatbots","chatops","devops","powershell"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/poshbotio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2017-01-04T07:49:41.000Z","updated_at":"2025-03-25T13:51:39.000Z","dependencies_parsed_at":"2024-09-24T05:01:09.379Z","dependency_job_id":"f75527d8-b0c0-45d6-90ab-5720a270bcef","html_url":"https://github.com/poshbotio/PoshBot","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poshbotio%2FPoshBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poshbotio%2FPoshBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poshbotio%2FPoshBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poshbotio%2FPoshBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/poshbotio","download_url":"https://codeload.github.com/poshbotio/PoshBot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247997885,"owners_count":21030696,"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":["bot","bot-framework","bots","chatbot","chatbot-framework","chatbots","chatops","devops","powershell"],"created_at":"2024-08-01T16:01:38.382Z","updated_at":"2025-04-09T07:33:47.788Z","avatar_url":"https://github.com/poshbotio.png","language":"PowerShell","readme":"\n# PoshBot\n\n| Azure Pipelines | GitHub Actions | Documentation | PS Gallery | License |\n|-----------------|----------------|---------------|------------|---------|\n[![Azure Pipelines Build Status][azure-pipeline-badge]][azure-pipeline-build] | [![GitHub Actions Status][github-actions-badge]][github-actions-build] | [![Documentation Status][docs-badge]][docs] | [![PowerShell Gallery][psgallery-badge]][psgallery] | [![License][license-badge]][license]\n\u003c!-- [![Patreon](https://img.shields.io/badge/patreon-donate-yellow.svg)](https://www.patreon.com/devblackops/memberships) --\u003e\n\n---\n\n\u003ch2 align=\"center\"\u003eSupporting PoshBot\u003c/h2\u003e\n\nPoshBot is a MIT-licensed open source project. Ongoing development is made possible thanks to the support of sponsors.\nIf you'd like to become a sponsor, you can do so through [GitHub Sponsors](https://github.com/users/devblackops/sponsorship) or [Patreon](https://www.patreon.com/bePatron?u=10352866).\n\n\u003ch4 align=\"center\"\u003eSilver Sponsors\u003c/h4\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://chocolatey.org/\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\u003cimg src=\"Media/sponsors/chocolatey_logo_long.png\" height=\"70px\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n---\n\nWant some in-depth guides? Check out [ChatOps the Easy Way](https://leanpub.com/chatops-the-easy-way) on [Leanpub](https://leanpub.com/)!\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://leanpub.com/chatops-the-easy-way\" target=\"_blank\" title=\"ChatOps the Easy Way\"\u003e\n        \u003cimg src=\"https://s3.amazonaws.com/titlepages.leanpub.com/chatops-the-easy-way/medium?1530164567\" alt=\"ChatOps the Easy Way\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\n# Introduction\n\nPoshBot is a chat bot written in [PowerShell](https://msdn.microsoft.com/powershell).\nIt makes extensive use of classes introduced in PowerShell 5.0.\nPowerShell modules are loaded into PoshBot and instantly become available as bot commands.\nPoshBot currently supports connecting to Slack to provide you with awesome ChatOps goodness.\n\n\u003c!-- \u003cp align=\"center\"\u003e\n  \u003cimg style=\"height:250px;\" src=\"https://raw.githubusercontent.com/poshbotio/PoshBot/master/Media/poshbot_logo_300_432.png\" alt=\"PoshBot logo\"/\u003e\n\u003c/p\u003e --\u003e\n\n## What Can PoshBot Do?\n\nPretty much anything you want :) No seriously.\nPoshBot executes functions or cmdlets from PowerShell modules.\nUse PoshBot to connect to servers and report status, deploy code, execute runbooks, query APIs, etc.\nIf you can write it in PowerShell, PoshBot can execute it.\n\n## Documentation\n\nDetailed documentation can be found at [ReadTheDocs](http://poshbot.readthedocs.io/en/latest/).\n\n## Building PoshBot\n\nSee [Building PoshBot](./building.md) for documentation on how to build PoshBot from source.\n\n## Changelog\n\nDetailed changes for each release are documented in the [release notes](https://github.com/poshbotio/poshbot/releases).\n\n## [YouTube] PowerShell Summit 2018 - Invoke-ChatOps: Level up and change your culture with chat and PowerShell\n\n[![Alt text](https://i.ytimg.com/vi/Mrs49IdnSHc/hqdefault.jpg?sqp=-oaymwEZCNACELwBSFXyq4qpAwsIARUAAIhCGAFwAQ==\u0026rs=AOn4CLDdWnuXllwxfDRO_LGa0h_h_VGPPQ)](https://youtu.be/Mrs49IdnSHc)\n\n## Quickstart\n\nTo get started now, get a SLACK-API-TOKEN for your bot:\n\n[https://my.slack.com/services/new/bot](https://my.slack.com/services/new/bot)\n\n```powershell\n# Install the module from PSGallery\nInstall-Module -Name PoshBot -Repository PSGallery\n\n# Import the module\nImport-Module -Name PoshBot\n\n# Create a bot configuration\n$botParams = @{\n    Name = 'name'\n    BotAdmins = @('\u003cSLACK-CHAT-HANDLE\u003e')\n    CommandPrefix = '!'\n    LogLevel = 'Info'\n    BackendConfiguration = @{\n        Name = 'SlackBackend'\n        Token = '\u003cSLACK-API-TOKEN\u003e'\n    }\n    AlternateCommandPrefixes = 'bender', 'hal'\n}\n\n$myBotConfig = New-PoshBotConfiguration @botParams\n\n# Start a new instance of PoshBot interactively or in a job.\nStart-PoshBot -Configuration $myBotConfig #-AsJob\n```\n\nBasic usage:\n\n```powershell\n# Create a Slack backend\n$backendConfig = @{Name = 'SlackBackend'; Token = '\u003cSLACK-API-TOKEN\u003e'}\n$backend = New-PoshBotSlackBackend -Configuration $backendConfig\n\n# Create a PoshBot configuration\n$pbc = New-PoshBotConfiguration -BotAdmins @('\u003cMY-SLACK-HANDLE\u003e') -BackendConfiguration $backendConfig\n\n# Save configuration\nSave-PoshBotConfiguration -InputObject $pbc -Path .\\PoshBotConfig.psd1\n\n# Load configuration\n$pbc = Get-PoshBotConfiguration -Path .\\PoshBotConfig.psd1\n\n# Create an instance of the bot\n$bot = New-PoshBotInstance -Configuration $pbc -Backend $backend\n\n# Start the bot\n$bot.Start()\n\n# Available commands\nGet-Command -Module PoshBot\n\nCommandType     Name                                               Version    Source\n-----------     ----                                               -------    ------\nFunction        Get-PoshBot                                        0.12.0     poshbot\nFunction        Get-PoshBotConfiguration                           0.12.0     poshbot\nFunction        Get-PoshBotStatefulData                            0.12.0     poshbot\nFunction        New-PoshBotCardResponse                            0.12.0     poshbot\nFunction        New-PoshBotConfiguration                           0.12.0     poshbot\nFunction        New-PoshBotDiscordBackend                          0.12.0     poshbot\nFunction        New-PoshBotFileUpload                              0.12.0     poshbot\nFunction        New-PoshBotInstance                                0.12.0     poshbot\nFunction        New-PoshBotMiddlewareHook                          0.12.0     poshbot\nFunction        New-PoshBotScheduledTask                           0.12.0     poshbot\nFunction        New-PoshBotSlackBackend                            0.12.0     poshbot\nFunction        New-PoshBotTeamsBackend                            0.12.0     poshbot\nFunction        New-PoshBotTextResponse                            0.12.0     poshbot\nFunction        Remove-PoshBotStatefulData                         0.12.0     poshbot\nFunction        Save-PoshBotConfiguration                          0.12.0     poshbot\nFunction        Set-PoshBotStatefulData                            0.12.0     poshbot\nFunction        Start-PoshBot                                      0.12.0     poshbot\nFunction        Stop-Poshbot                                       0.12.0     poshbot\n```\n\n[azure-pipeline-badge]: https://dev.azure.com/devblackops/PoshBot/_apis/build/status/PoshBot-CI\n[azure-pipeline-build]: https://dev.azure.com/devblackops/PoshBot/_build/latest?definitionId=3\n[github-actions-badge]: https://github.com/poshbotio/PoshBot/workflows/CI/badge.svg\n[github-actions-build]: https://github.com/poshbotio/PoshBot/actions\n[docs-badge]: https://readthedocs.org/projects/poshbot/badge/?version=latest\n[docs]: http://poshbot.readthedocs.io/en/latest/\n[psgallery-badge]: https://img.shields.io/powershellgallery/dt/poshbot.svg\n[psgallery]: https://www.powershellgallery.com/packages/poshbot\n[license-badge]: https://img.shields.io/github/license/poshbotio/poshbot.svg\n[license]: https://www.powershellgallery.com/packages/poshbot\n","funding_links":["https://www.patreon.com/devblackops/memberships","https://www.patreon.com/bePatron?u=10352866"],"categories":["PowerShell","Misc","Frameworks and libraries"],"sub_categories":["Slack"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fposhbotio%2FPoshBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fposhbotio%2FPoshBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fposhbotio%2FPoshBot/lists"}