Spin it up

Demo controls

One click puts Layla in out-of-hours mode (same agent, same number) and opens a new Demo shift, so calls during the meeting show up as tonight's shift on the Overnight page. The override lives in Postgres (app_settings), so tools, SLAs, the website greeting and the report all follow it. db/reset_demo.sh turns it off.

Start

In VS Code, open the terminal (Ctrl + `). It opens in the project folder.

./start.sh

This takes about 30 seconds and opens the customer page and this report. Add --no-open to skip opening them, or --redeploy to push prompt or tool changes to Layla.

./stop.sh          # stops the tunnel and Postgres (data is kept)
./stop.sh --all    # also stops the n8n container

What start.sh does

First time on a new machine

1. Install Docker Desktop, Python 3 and cloudflared (brew install cloudflared).
2. Run n8n in Docker and create an API key in n8n under Settings → n8n API.
3. cp .env.example .env, then fill in ELEVENLABS_API_KEY, N8N_API_KEY, VOICEPILOT_KEY and your n8n container name.
4. Create db/.env with POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB=voicepilot and VOICEPILOT_APP_PASSWORD.
5. Run ./start.sh.

Both .env files, .run/ and config.js are gitignored. The scripts never print keys.

Prompt for VS Code (Claude Code)

Paste this into Claude Code in VS Code and it will bring the stack up and fix anything that fails.

Start the VoicePilot demo in this repo. Run ./start.sh --no-open and fix anything that fails (Docker Desktop not running, the n8n container stopped, Postgres not healthy, the tunnel not reachable). Then confirm, with evidence:
1. voicepilot-postgres is healthy on localhost:5433 and the voicepilot schema has customers and kb_articles.
2. The n8n workflow "VoicePilot AI | Construction customer care" is active and the tool, post-call, kpi and data webhooks answer locally.
3. The tunnel URL in .run/tunnel_url reaches n8n, and Layla's ElevenLabs tools and post-call webhook point at it. If they don't, run ./start.sh --redeploy.
4. A test call to the search_help_center tool through the tunnel creates a row in voicepilot.tool_events.
Finally open web/index.html and dashboard/live.html and give me the URLs. Never print or commit anything from .env or db/.env.

Phone number for testing

Layla answers calls through a Twilio number (or a SIP trunk) connected in ElevenLabs. Caller ID lets her verify a customer without asking for their name.

set -a; . ./.env; set +a
python3 elevenlabs/assign_phone.py --list
python3 elevenlabs/assign_phone.py +1XXXXXXXXXX

Make caller ID verification work for you

Put your own mobile on a demo customer, then call the number:

docker exec voicepilot-postgres psql -U voicepilot_owner -d voicepilot -c "update voicepilot.customers set phone = '+9715XXXXXXXX' where customer_id = 'C-1002'"

Re-running db/setup.sh or ./start.sh resets the demo phone numbers.

Call doesn't connect?

• Check whether the call reached ElevenLabs: Agents → Layla → Call history. If it isn't there, the problem is before ElevenLabs.
• Twilio trial accounts can only take calls from verified caller IDs. Add your mobile in Twilio under Phone numbers → Verified caller IDs, or upgrade the account.
• In the Twilio console, under Monitor → Logs → Calls, a failed or blocked call shows the reason (for example a geo-permission or trial restriction).
• The number's Voice webhook in Twilio must point to ElevenLabs (api.us.elevenlabs.io/twilio/inbound_call). Importing it through ElevenLabs sets this.
• Calling a US number from the UAE: some mobile plans block international calls or WhatsApp-style VoIP routes. Try calling from Skype or Google Voice, or ask Twilio for a UK number.

Host the website for free

Only the Crestline website (site/) goes public. The report, live data and demo guide stay on your machine because they show customer data.

1. ngrok (permanent address for n8n): sign up free at dashboard.ngrok.com. Copy Your Authtoken, then under Domains claim your free static domain (for example crestline-demo.ngrok-free.app).
2. Cloudflare Pages (hosts the site): sign up free at dash.cloudflare.com. Copy your Account ID (Workers & Pages overview, right side). Then go to My Profile → API Tokens → Create Token → Custom token, with permission Account → Cloudflare Pages → Edit.
3. Add to .env:

   NGROK_AUTHTOKEN=...
   NGROK_DOMAIN=your-name.ngrok-free.app
   CLOUDFLARE_API_TOKEN=...
   CLOUDFLARE_ACCOUNT_ID=...
   VP_PAGES_PROJECT=crestline-demo

4. Run ./start.sh --redeploy once. Layla's tools, the post-call webhook and the website now use the permanent address, and the site is live at https://crestline-demo.pages.dev. Every later ./start.sh republishes it.

The site and Layla only work while this Mac runs n8n and the tunnel. For always-on, move n8n and Postgres to a small cloud server.

WhatsApp and email confirmations

Every booking, reschedule, cancellation, ticket and callback writes a WhatsApp message and an email, in the customer's language, to voicepilot.notifications (see Live data → Outbox). n8n sends them right after the tool call. Until a provider is connected they are marked simulated, so nothing reaches the fake demo numbers.

During demos set VP_DEMO_PHONE and VP_DEMO_EMAIL to your own number and email so every confirmation comes to you. Then run ./start.sh. For a real client, WhatsApp needs a verified WhatsApp Business account (through Twilio, Meta or 360dialog) with approved message templates.

Where things are

Troubleshooting