# probot
> A framework for building GitHub Apps to automate and improve your workflow
Latest version **14.3.2** (published 2026-04-03) · ISC license · 0 weekly downloads
## Install
```sh
npm install probot
pnpm add probot
yarn add probot
bun add probot
```
Provides the command `probot`.
## Health
**Score 70/100 (B)** — status: active.
Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.
Warnings: low downloads.
## Facts
| | |
|---|---|
| Version | 14.3.2 |
| Published | 2026-04-03 |
| First published | 2017-03-19 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^20.18.1 \|\| >= 22 |
| Dependencies | 22 |
| Unpacked size | 158.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 9609 |
| Author | Brandon Keepers |
| Maintainers | bkeepers, gr2m, jasonetco, tcbyrd, hiimbex, probotbot |
| Keywords | probot, github-apps, github, automation, robots, workflow |
## Links
- npm: https://www.npmjs.com/package/probot
- Repository: https://github.com/probot/probot
- Homepage: https://probot.github.io
- Issues: https://github.com/probot/probot/issues
- npm.io page: https://npm.io/package/probot
## Dependencies (22)
- [pino](https://npm.io/package/pino.md) ^10.0.0
- [yaml](https://npm.io/package/yaml.md) ^2.8.1
- [deepmerge](https://npm.io/package/deepmerge.md) ^4.3.1
- [pino-http](https://npm.io/package/pino-http.md) ^11.0.0
- [bottleneck](https://npm.io/package/bottleneck.md) ^2.19.5
- [toad-cache](https://npm.io/package/toad-cache.md) ^3.7.0
- [@probot/pino](https://npm.io/package/@probot/pino.md) ^5.0.1
- [@octokit/core](https://npm.io/package/@octokit/core.md) ^7.0.3
- [@octokit/types](https://npm.io/package/@octokit/types.md) ^16.0.0
- [package-config](https://npm.io/package/package-config.md) ^5.0.0
- [@octokit/request](https://npm.io/package/@octokit/request.md) ^10.0.3
- [npx-import-light](https://npm.io/package/npx-import-light.md) ^1.0.0
- [@octokit/webhooks](https://npm.io/package/@octokit/webhooks.md) ^14.1.2
- [import-meta-resolve](https://npm.io/package/import-meta-resolve.md) ^4.1.0
- [octokit-auth-probot](https://npm.io/package/octokit-auth-probot.md) ^4.0.1
- [@octokit/plugin-retry](https://npm.io/package/@octokit/plugin-retry.md) ^8.0.1
- [@probot/get-private-key](https://npm.io/package/@probot/get-private-key.md) ^2.1.1
- [@octokit/plugin-throttling](https://npm.io/package/@octokit/plugin-throttling.md) ^11.0.1
- [@octokit/plugin-paginate-rest](https://npm.io/package/@octokit/plugin-paginate-rest.md) ^14.0.0
- [@probot/octokit-plugin-config](https://npm.io/package/@probot/octokit-plugin-config.md) ^4.0.0
- [@octokit/plugin-rest-endpoint-methods](https://npm.io/package/@octokit/plugin-rest-endpoint-methods.md) ^17.0.0
- [@octokit/plugin-enterprise-compatibility](https://npm.io/package/@octokit/plugin-enterprise-compatibility.md) ^6.0.1
## Recent versions
- 14.3.2 (latest) — 2026-04-03
- 14.0.0-beta.31 (beta) — 2025-07-30
- 12.4.0 (release-12.x) — 2024-06-03
- 9.14.2 (release-9.x) — 2021-07-07
- 11.0.0 (next) — 2020-12-15
- 7.5.3 (release-7.x) — 2019-04-12
- 14.3.1 — 2026-03-20
- 14.3.0 — 2026-03-16
- 14.2.4 — 2025-11-14
- 14.2.3 — 2025-11-13
- 14.2.2 — 2025-11-13
- 14.2.1 — 2025-10-15
- 14.2.0 — 2025-10-14
- 14.1.0 — 2025-10-11
- 14.0.6 — 2025-10-04
- … 360 more at https://npm.io/package/probot/versions
## README
A framework for building GitHub Apps to automate and improve your workflow
---
If you've ever thought, "wouldn't it be cool if GitHub could…"; I'm going to stop you right there. Most features can actually be added via [GitHub Apps](https://docs.github.com/en/developers/apps), which extend GitHub and can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. Apps are first class actors within GitHub.
## How it works
**Probot is a framework for building [GitHub Apps](https://docs.github.com/en/developers/apps) in [Node.js](https://nodejs.org/)**, written in [TypeScript](https://www.typescriptlang.org/). GitHub Apps can listen to webhook events sent by a repository or organization. Probot uses its internal event emitter to perform actions based on those events. A simple Probot App might look like this:
```js
export default (app) => {
app.on("issues.opened", async (context) => {
const issueComment = context.issue({
body: "Thanks for opening this issue!",
});
return context.octokit.issues.createComment(issueComment);
});
app.onAny(async (context) => {
context.log.info({ event: context.name, action: context.payload.action });
});
app.onError(async (error) => {
app.log.error(error);
});
};
```
## Building a Probot App
If you've landed in this GitHub repository and are looking to start building your own Probot App, look no further than [probot.github.io](https://probot.github.io/docs/)! The Probot website contains our extensive getting started documentation and will guide you through the set up process.
This repository hosts the code for the npm Probot package which is what all Probot Apps run on. Most folks who land in this repository are likely looking to get started [building their own app](https://probot.github.io/docs/).
## Contributing
Probot is built by people just like you! Most of the interesting things are built _with_ Probot, so consider starting by [writing a new app](https://probot.github.io/docs/) or improving one of the [existing ones](https://github.com/search?q=topic%3Aprobot-app&type=Repositories).
If you're interested in contributing to Probot itself, check out our [contributing docs](CONTRIBUTING.md) to get started.
Want to discuss with Probot users and contributors? [Discuss on GitHub](https://github.com/probot/probot/discussions)!
## Ideas
Have an idea for a cool new GitHub App (built with Probot)? That's great! If you want feedback, help, or just to share it with the world you can do so by [creating an issue in the `probot/ideas` repository](https://github.com/probot/ideas/issues/new)!
---
_Source: https://npm.io/package/probot · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._