---
url: https://bishop.agentdeployment.co/install.md
description: Installing Bishop from npm or from source, and the Node version it needs.
---

# Install

Bishop is an npm package that needs Node 24 or newer.

```sh
npm install -g @agentdeploymentco/bishop
```

That puts `bishop` on your PATH. Bishop treats the directory it runs from as its own home, and as the agent unless [`--agent`](/running/agent) points elsewhere, so run it from the agent's directory. The [container image](/deploying/container) is the other way to run it, and [Linux and systemd](/deploying/linux) covers a host without Docker.

## Requirements

* Node 24 or newer. Bishop imports `node:sqlite`.
* A directory the agent works in, meaning `claude` or `codex` runs there and does something useful. Bishop manages no model credentials: each harness authenticates however its own CLI does in that directory.
* At least one interface, each with its own setup requirements:
  * **Slack:** the [`slack` CLI](https://docs.slack.dev/tools/slack-cli/), logged in with `slack auth login`, and permission to install an app in your workspace. Without the CLI, you can [set the app up by hand](/interfaces/slack#without-the-slack-cli).
  * **Email:** a Google Workspace account, a Google Cloud project, and a Workspace user for the agent.
  * **Microsoft Teams:** the [Teams Developer CLI](https://microsoft.github.io/teams-sdk/), logged in with `teams login`, unless an administrator creates the app for you, plus a way for Teams to reach this host over HTTPS. Reading or sending a file in a Teams channel also needs the [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli).

## From source

The published package is minified and carries no source maps. If you work on Bishop, and so can read its repository, build it instead:

```sh
git clone https://github.com/Agent-Deployment-Co/bishop.git
cd bishop
npm install
npm run build
npm link          # optional, puts `bishop` on your PATH
```

Without `npm link`, run it as `node /path/to/bishop/dist/cli.js`.

## Upgrading

Install the new version and restart. [Upgrading](/deploying/upgrading) covers database migrations and how to roll one back.