Skip to content

Repository files navigation

Scout

autonomous voice buyer that calls, compares, and haggles — with receipts.

built for ElevenLabs Hack-Nation · The Negotiator
live product · real outbound calls · verified leverage only · never invents competitor prices


demo (start here)

product walkthrough

scout-demo.mp4
Evidence Conversation Video Audio What it shows
Product walkthrough Playing above Confirmed property brief → discovery → parallel negotiation → evidence-backed recommendation
Negotiation call 1 conv_5201kxx76rwvebfb1s430ve2nm5h Open inline player Listen Hindi-first hostel availability, scope, and price discussion
Negotiation call 2 conv_9401kxx51dk6fxgveay6375kr57n Open inline player Listen Bounded, truthful India-hostel negotiation and clean close

negotiation call 1

▶ Play video and listen to the negotiation
negotiation-call-1.mp4

https://github.com/user-attachments/files/30166025/negotiation-call-1-conv_5201kxx76rwvebfb1s430ve2nm5h.mp3

negotiation call 2

▶ Play video and listen to the negotiation
negotiation-call-2.mp4

https://github.com/user-attachments/files/30166024/negotiation-call-2-conv_9401kxx51dk6fxgveay6375kr57n.mp3


what it is

people shopping for high-friction local services (movers, hostels, contractors) waste hours calling vendors one-by-one. quotes are inconsistent. leverage dies between calls.

Scout turns one confirmed brief into:

  1. discovery (OpenStreetMap)
  2. parallel voice calls (ElevenLabs → Twilio)
  3. itemized, comparable quotes
  4. haggling that may only cite verified competing bids
  5. a ranked recommendation with transcript evidence

hard rule: Scout never pays, signs, or binds the customer. AI discloses when asked.

first vertical: moving. live multilingual path: India hostel / PG (Hindi-first + Indian English).


stack that gives us an edge

ElevenLabs · Twilio · Next.js · Node orchestrator · OpenStreetMap · Tavily · Gemini / Claude (via ElevenLabs) · OpenAI helpers · pnpm monorepo · simulated market · verified-leverage strategy engine

honesty is enforced in code — the voice LLM speaks; the orchestrator decides tactics and which numbers are allowed.


repository map

apps/
  web/                intake, live activity, comparison UI (Vercel)
  orchestrator/       call lifecycle, strategy, ranking, audit
  voice-agents/       ElevenLabs intake + negotiator prompts/tools
  simulated-market/   deterministic seller styles (no phone credits)
packages/
  contracts/          RequirementSpec · CallOutcome · Quote · Recommendation
  vertical-config/    fees, red flags, negotiation levers
  evals/              golden-call fixtures
media/demo/           demo video · bargaining audio · source zip
docs/                 architecture, submission copy, Notebook LM prompt
START-HERE.md         how to read this repo / the zip

how to read this repo

  1. this README (demo links above)
  2. START-HERE.md — reading order for the zip / new contributors
  3. docs/ARCHITECTURE.md — system boundaries
  4. docs/negotiation-engine.md — verified leverage
  5. docs/voice-and-multilingual.md — Hindi / accent path
  6. apps/voice-agents/src/agents/negotiator.md — what the agent is allowed to say
  7. apps/orchestrator/src/negotiation/strategy-engine.js — next move brain

Hack-Nation form copy: docs/hack-nation-submission.md


non-negotiable demo requirements

  • one confirmed requirement spec reused across every call
  • ≥3 distinct counterparty / negotiation styles
  • itemized, comparable quote outcomes
  • at least one genuine, evidence-based price/term change
  • ranked recommendation linked to transcript evidence
  • honest AI disclosure · no fabricated bids · no authority to commit funds

run locally

pnpm install
pnpm --filter @scout/orchestrator serve
pnpm --filter @scout/web dev

open http://localhost:3000 — or jump to /moving / /real-estate

outbound calls stay disabled until OUTBOUND_CALLS_ENABLED=true and keys are set (see .env.example).

no-credit smoke path:

node apps/simulated-market/src/simulator.smoke.js
node apps/orchestrator/src/moving/moving-workflow.smoke.js

live ElevenLabs tool boundary: docs/AGENT-TOOLS.md


deploy


project meta

challenge The Negotiator — voice agents that call, compare, and haggle
team id HN-1602
github nothariharan/scout
live scout-dusky-six.vercel.app

About

Resources

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages