Check its license. It has its own license: read it before using it for work.

Is openbot still maintained?

Yes, active. Last change today. Latest release v0.69.0, today.

Some track record. 7.3k stars, 3 months old, by an organization. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install openbot on macOS (nightly-labs/openbot) · gitmanual

How to install on macOS

nightly-labs/openbot

A local-first desktop workspace for persistent AI teammates. Run Codex, Claude, and Grok with dedicated workspaces, task queues, file sharing, browser control, and agent-to-agent collaboration.

Node.jsVite#ai-agents#bun#codex#electron

Before you start

Is it free?: Check its licenseIt has its own license: read it before using it for work.
Still maintained?: Yes, activeLast change today. Latest release v0.69.0, today.
Can I trust it?: Some track record7.3k stars, 3 months old, by an organization. Get it from the official repo and read what it installs.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 7,251
Activity: Updated this month

Saved setup from 5 h ago

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Website ↗openbot.runThe project's own site.

Heads-upBuilding it yourself? It also needs 61 settings in .env (18 secret).

Download for macOS

OpenBot v0.69.0 · 11/12/2026 ↗

OpenBot-0.69.0-arm64.dmg

dmg · Apple Silicon · 269.2 MB · 214 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/nightly-labs/openbot/releases/download/v0.69.0/OpenBot-0.69.0-arm64.dmg"
open "OpenBot-0.69.0-arm64.dmg"

Other macOS downloads (2)

OpenBot-Host-0.69.0-arm64.pkg

pkg · Apple Silicon · 52.5 MB · 1 downloads

Download

curl -LO "https://github.com/nightly-labs/openbot/releases/download/v0.69.0/OpenBot-Host-0.69.0-arm64.pkg"
sudo installer -pkg "OpenBot-Host-0.69.0-arm64.pkg" -target /

OpenBot-0.69.0-x64.dmg

dmg · Intel · 278.0 MB · 8 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/nightly-labs/openbot/releases/download/v0.69.0/OpenBot-0.69.0-x64.dmg"
open "OpenBot-0.69.0-x64.dmg"

Install with a package manager

Nix

nix run github:nightly-labs/openbot

Nix

nix profile install github:nightly-labs/openbot

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 12 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js 24runtime
1×Bun runtime
1×Docker tool
1×bun bun@1.4.2package manager

61× settings in .env

ACME_EMAIL
SIGNAL_DOMAIN
TURN_DOMAIN
TURN_PUBLIC_IP
REMOTE_SIGNAL_BIND_ADDRESS
REMOTE_SIGNAL_PUBLIC_PORT
REMOTE_SIGNAL_PORT
REMOTE_TLS_DISABLED
CLOUDFLARE_DNS_API_TOKENsecret
ACME_CERTIFICATE_GROUP_ID
REMOTE_TICKET_JWKS_URL
REMOTE_CONTROL_PLANE_URL
REMOTE_SESSION_SECRETsecret
REMOTE_AUTH_WEBHOOK_SECRETsecret
REMOTE_METRICS_TOKENsecret
REMOTE_MAX_CONNECTIONS_PER_USER
REMOTE_MAX_CONNECTIONS_PER_IP
REMOTE_MAX_MESSAGES_PER_MINUTE
REMOTE_TRUST_PROXY
TURN_SHARED_SECRETsecret
SLACK_SIGNING_SECRETsecret
GITHUB_WEBHOOK_SECRETsecret
DISCORD_BOT_TOKENsecret
DISCORD_APPLICATION_ID
DISCORD_MESSAGE_CONTENT
TELEGRAM_BOT_TOKENSsecret
TELEGRAM_WEBHOOK_SECRETsecret
TELEGRAM_WEBHOOK_ORIGINoptional
AUTH_EXPOSE_DEVELOPMENT_CODE
EMAIL_SMTP_HOST
EMAIL_SMTP_PORT
EMAIL_SMTP_USERNAME
EMAIL_SMTP_PASSWORDsecret
EMAIL_FROM
EMAIL_LICENSE_FROMoptional
EMAIL_DELIVERY_WEBHOOK_URL
EMAIL_DELIVERY_WEBHOOK_SECRETsecret
SKILLS_ADMIN_TOKENsecret
SERVER_CLAIMS_ADMIN_TOKENsecret
SITE_REPORT_HASH_SECRETsecret
COMPANY_SIGN_IN_SECRETsecret
SITE_PUBLISH_ENABLED
SITE_COOKIE_ISOLATION_READY
REMOTE_TICKET_PRIVATE_JWKsecret
REMOTE_TICKET_PUBLIC_JWKS
REMOTE_TICKET_KEY_IDsecret
REMOTE_SIGNAL_URL
REMOTE_SIGNAL_HOMESoptional
REMOTE_SIGNAL_HOME_LOCATIONSoptional
REMOTE_AUTH_WEBHOOK_URLoptional
REMOTE_AUTH_WEBHOOK_URLSoptional
TELEGRAM_BOT_IDoptional
TELEGRAM_BOT_USERNAMEoptional
STRIPE_SECRET_KEYsecretoptional
STRIPE_PUBLISHABLE_KEYsecretoptional
GITHUB_APP_PRIVATE_KEYsecretoptional
APNS_PRIVATE_KEYsecretoptional
APNS_KEY_IDsecretoptional
APNS_TEAM_IDoptional
APNS_TOPICoptional

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/nightly-labs/openbot/badge.svg)](https://gitmanual.com/nightly-labs/openbot)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: apps/auth-api/package.json, apps/mobile-updates/package.json, apps/mobile/package.json, apps/site-router/package.json and 11 more

Details

License: Not detected
Open issues: 2,035
Branch: main

package.json scripts (394)

preparebun scripts/install-git-hooks.ts
postinstallbun scripts/electron-dist-cache.ts restore && bun scripts/install-electron.ts && bun scripts/electron-dist-cache.ts save && bun scripts/stamp-install.ts
api:startbun run --cwd apps/auth-api start
api:buildbun run --cwd apps/auth-api build
api:imagesbun run --cwd apps/auth-api images
api:deploybun run --cwd apps/auth-api deploy
hosting:templatebun scripts/hosting/build-boat-template.ts
hosting:setupbun scripts/hosting/setup-account-server.ts
api:deploy:testbun run --cwd apps/auth-api deploy:test
status:buildbun run --cwd apps/status build
status:smokebun scripts/status-page-smoke.ts
sites:deploybun run --cwd apps/site-router deploy
sites:bucket:createbunx wrangler r2 bucket create openbot-sites --storage-class Standard
updates:deploybun run --cwd apps/mobile-updates deploy
updates:bucket:createbunx wrangler r2 bucket create openbot-mobile-updates --storage-class Standard
sites:lifecyclebunx wrangler r2 bucket lifecycle set openbot-sites --file apps/site-router/r2-lifecycle.json --force
api:migrate:localbun run --cwd apps/auth-api db:migrate:local
api:migrate:remotebun run --cwd apps/auth-api db:migrate:remote
api:stripe:bootstrapbun run --cwd apps/auth-api stripe:bootstrap
remote:upremote/bin/dotenvx run --overload -f remote/.env.production -fk remote/.env.keys -- docker compose -f remote/compose.yaml up -d --build
remote:downremote/bin/dotenvx run --overload -f remote/.env.production -fk remote/.env.keys -- docker compose -f remote/compose.yaml down
remote:logsremote/bin/dotenvx run --overload -f remote/.env.production -fk remote/.env.keys -- docker compose -f remote/compose.yaml logs -f remote-api coturn
remote:checkbun remote/scripts/check.ts
remote:check:composebun remote/scripts/check.ts --compose
remote:env:validatecd remote && bin/dotenvx validate -f .env.production -fk .env.keys

Files we read (12)

.github/workflows/changelog.yml

.github/workflows/ci.yml

.github/workflows/cla.yml

.github/workflows/cloudflare-preview.yml

.github/workflows/contribution-policy.yml

.github/workflows/cua-driver.yml

.nvmrc

CONTRIBUTING.md

README.md

apps/auth-api/.env.example

package.json

remote/.env.example

8,792 files in the repo

Yes, it installs on your macOS

Start here

Download for macOS

Install with a package manager

Did you get it running?

Still stuck? Get a written guide

More like openbot that run on macOS