BELL is a reference architecture and sample app for building personal AI assistants that execute tasks on your behalf.
- Browserbase: Browser + Stagehand
- Eve by Vercel: Agent Framework
- Parallel: Public Web Research
- Link by Stripe: Payments
- Linq: Messaging Infrastruture
- 1Password: Authentication
- Baselayer: Identity
Requires Node.js 24, pnpm 10.33.4, and OpenAI and Browserbase API keys.
git clone https://github.com/browserbase/bell-stack.git
cd bell-stack
pnpm install --frozen-lockfile
cp .env.example .envSet OPENAI_API_KEY and BROWSERBASE_API_KEY in .env. For ordinary browsing, set BELL_DEMO_URL to your target website.
Set PARALLEL_API_KEY to enable public-web research. Keep research inputs public; use the browser for authenticated pages and actions.
pnpm dev
| Integration | What it does | Guide |
|---|---|---|
| Browserbase + Stagehand | Browser sessions, automation, saved Contexts, and human handoff | Browser runtime |
| Eve by Vercel | Agent configuration, tools, conversation state, and channels | Eve in Bell |
| Parallel | Public-web research and persistent watches with configurable frequency | Set PARALLEL_API_KEY in .env; watch setup |
| Linq | iMessage and SMS through a signed webhook and sender allowlist | Messaging setup |
| Link by Stripe | Wallet authorization, spend approval, and checkout through Linq | Sandbox and wallet setup |
| 1Password | Operator credentials and OTP; personal Agentic Autofill is disabled by default | Operator access · Personal access status |
| Baselayer | Proves a verified person is behind the agent, using short-lived credentials | Verified identity |
See the repository layout and implementation map to extend Bell.
pnpm check
Runs tests, type checking, lint, and the production build. Live provider checks are opt-in.
Bell is a sample app for one trusted operator. Before deploying, configure application authentication and durable storage using the browser runtime guide.
MIT.