qm

<p align="center">
  <img src="docs/images/qm-logo.png" alt="QM" width="120">
</p>

<div align="center">

**A multiplayer agent harness for teams. In Slack and on the web.**<br>
Run it in your own cloud, with your own models and keys.

[![CI](https://img.shields.io/github/actions/workflow/status/yc-software/qm/cicd.yml?branch=main&label=CI&style=flat-square)](https://github.com/yc-software/qm/actions/workflows/cicd.yml)
[![license](https://img.shields.io/badge/license-MIT-4c1?style=flat-square)](./LICENSE)
[![node](https://img.shields.io/badge/node-24.15%2B-3178c6?style=flat-square)](./package.json)
[![npm](https://img.shields.io/npm/v/@yc-software/qm?label=npm&color=000&style=flat-square)](https://www.npmjs.com/package/@yc-software/qm)

[Deploy](#deploy-it-for-your-org) · [How it works](#how-it-works) · [Security model](#security-and-secrets) · [Customize](#customize-your-instance) · [Contribute](#contributing) · [Documentation](https://labs.ycombinator.com/qm/)

</div>

## Overview

Most agents are designed like personal assistants. You can make one work for a whole
team, but it quickly gets complex. QM is designed for teams. Everyone gets
their own isolated workspace, and can also collaborate with the agent in channels, group messages, and projects.

Each person and each room has its own scoped memory, files, keychain view, permissions,
crons, web apps, and durable sandbox.

Agents are always on. Each one has its own computer and memory, and keeps working on
schedules and webhooks while you're away. Hosted always-on agents like ChatGPT Dots and
Grok Bot run in the vendor's cloud on the vendor's models. QM runs in yours.

It's built with open source in mind. Pick your own model and switch between models; Pi
runs models from many providers, so a deployment isn't tied to any single vendor.

## Setup

Tell your coding agent of choice `Let's deploy https://github.com/yc-software/qm`. From here, it should follow the deployment guide in this repo.

An easy way to run QM yourself is with [DigitalOcean](https://marketplace.digitalocean.com/apps/yc-qm), [E2B](https://e2b.dev/docs/agents/qm), or [Render](https://render.com/docs/deploy-yc-qm).

If you'd rather a fully hosted option, you can try [Agent 37](https://www.agent37.com/qm).

If you're an infra provider interested in offering a hosted version of QM, feel free to reach out.

If you're at a bigger company and are interested in a hosted version of QM, let us know [here](https://docs.google.com/forms/d/e/1FAIpQLSfEAhWOYgGHSNHHm7Ae5rS0qH72tZgjA32jDvNmhfFMGsTfOg/viewform).

## Features

- **Personal and shared scopes.** People customize the agent to be _theirs_, and still
  work with it collaboratively in Slack channels and projects.
- **Slack and web.** The same identity and configuration carries between Slack and the
  web app.
- **Admin control.** Set org-level configuration, security and sharing postures. Choose which
  models are available.
- **Web apps.** Spin up custom internal apps and publish