5 min read

The local web dashboard

openleads web                 # → http://127.0.0.1:8787
openleads web --port 9000     # custom port
openleads web --no-open       # don't auto-open a browser
openleads demo                # the same dashboard on an invented demo workspace

A full sales workspace in your browser — prospecting, a people and company database, lists, sequences, tasks, deals, templates, analytics and workflows — running on the same engine and the same local database as the CLI.


#Local-first, by construction

  • stdlib only. The server is a ThreadingHTTPServer from Python's standard library (openleads/web/server.py). No Flask, no Node, no build step.
  • Bound to localhost. It listens on 127.0.0.1, not reachable from your network.
  • Pre-built UI. The app is plain ES modules and CSS committed under openleads/web/static/ and shipped in the wheel. End users need no toolchain.
  • No external requests from the page. A strict same-origin Content-Security-Policy blocks third-party scripts, styles and fonts. The typeface ships inside the package, and there is no CDN and no analytics: nothing phones home.

#The pages

GroupPageWhat
WorkspaceHomeKPIs with trends (contacts, sends, reply rate, pipeline), a sends chart, the stage funnel, today's tasks, active sequences, recent activity and a setup checklist
Find peoplePlain-English search across every free source; results stream in, already scored and saved
PeopleThe contact database: filter sidebar with live counts, saved searches, configurable columns, bulk actions on a selection or every matching row, and a full contact record
CompaniesAccounts with tech stack, size, industry and stage; profile any company from its website
ListsPeople and company lists as cards; open, enroll, export
EngageSequencesStep timeline editor with A/B variants, live preview, contacts and Run now (guide)
TasksOverdue / Today / Upcoming queue and a one-at-a-time focus mode
TemplatesReusable emails with variables, spintax and a live preview
Compose & sendOne-off drafts for a set of people, edited inline, dry-run or live
PipelineDealsDrag-and-drop board with weighted forecast and deal records
AnalyticsSending, replies and conversion over time
ActivityThe workspace-wide feed, grouped by day, filterable
AutomateWorkflowsRecipes drawn as a node canvas (guide)
Recipes & watchersScheduled searches, alerts and run history
Import & enrichImport a CSV with column mapping; find and verify emails for a list
SettingsSettingsSender, mailbox, sending policy, AI, integrations, ICP scoring, and Data & backup
Data healthWhat to fix before sending, and duplicate merge
DoctorThe openleads doctor checks

The workspace guide covers what each of these does with your data.

Every record has its own URL, so you can bookmark or share a view on your own machine: #/people/jane@acme.com, #/companies/acme.com, #/sequences/3, #/deals/7, #/templates/2. Filters live in the URL too: #/people?stage=interested&tier=safe, #/activity?show=replies.

#Command palette and shortcuts

Press ⌘K (Ctrl+K) or / anywhere to search people and companies, jump to a page, or run an action (new task, deal, sequence, template or list; import a CSV; start the task queue; find new people for what you typed).

KeysDoes
⌘K · /Command palette
G then H, F, P, C, L, S, T, M, D, A, V, W, IGo to Home, Find, People, Companies, Lists, Sequences, Tasks, Templates, Deals, Analytics, Activity, Workflows, Import
NThe page's New button
TToggle dark mode
?List every shortcut
Enter · S · ZIn the task queue: complete, skip, snooze
[ · ]On a focused deal card: move it a stage back or forward

Shortcuts never fire while you're typing or inside a dialog.

#Reading an email address

Every address carries one small mark. Its shape says how OpenLeads knows the address, and its color says whether it will deliver:

MarkMeaning
filled squareFound: published on the web or confirmed by the mail server
half-filled squarePattern: built from an address format seen at that company
outlined squareGuessed: a common format with nothing confirming it
green, amber, redDeliverable, risky, will bounce

Hover a mark for the full reason; the contact record lists every check. The same marks appear in tables, records, search results and exports.

#Light and dark

The interface follows your system theme; the moon/sun button (or T) pins one. It uses Atkinson Hyperlegible, a typeface drawn so that characters like l, I and 1 can't be mistaken for each other, which matters when you're reading email addresses. It respects prefers-reduced-motion and works down to phone width.

#The JSON API

The server exposes a JSON API that the UI uses and you can script against. Long-running actions stream newline-delimited JSON so progress renders live.

AreaEndpoints
EngineGET /api/state · GET /api/sources · POST /api/find (stream) · /api/verify · /api/write · /api/send (stream) · /api/run (stream) · /api/enrich (stream)
WorkspaceGET /api/meta · /api/home · /api/health · /api/activity
PeoplePOST /api/people/search · /facets · /create · /update · /tags · /bulk · /export · GET /api/people/get
CompaniesPOST /api/companies/search · /create · /update · /bulk · /profile · /enrich (stream) · GET /api/companies/get
Lists, tags, notesGET /api/lists · POST /api/lists/save · /add · /remove · /delete · GET /api/tags · POST /api/notes/add · …
SequencesGET /api/sequences · /get · POST /api/sequences/save · /status · /enroll · /unenroll · /pause · /preview · /run (stream)
Tasks, dealsGET /api/tasks · POST /api/tasks/save · /complete · /skip · /reopen · GET /api/deals · POST /api/deals/save · /move
TemplatesGET /api/templates · POST /api/templates/save · /preview · /delete
DataPOST /api/import/preview · /api/import · GET /api/duplicates · POST /api/duplicates/merge · GET /api/scoring · POST /api/scoring/save · /preview · /explain
SettingsGET/POST /api/settings · GET /api/doctor

Errors come back as JSON with an error message and a 4xx status; the server never sends a traceback to the client.

Stream events look like:

{"type":"phase","message":"searching yc…"}
{"type":"lead","lead":{"email":"ada@acme.ai","tier":"safe","score":96, ...}}
{"type":"done","count":41,"safe":41,"risky":9,"leads":[...]}

#Security

The dashboard can send email from your mailbox, so it treats every other website open in your browser as hostile:

  • Localhost only. It binds 127.0.0.1 and refuses any request whose Host header isn't a loopback name, which stops DNS-rebinding attacks. Add names with OPENLEADS_ALLOWED_HOSTS=myhost.lan if you put it behind your own proxy.
  • No cross-site requests. Requests marked cross-site by the browser (Sec-Fetch-Site), or carrying an Origin other than the dashboard's own (including Origin: null from sandboxed frames and file:// pages), get 403.
  • JSON only. Every write must be Content-Type: application/json (415 otherwise), which a plain HTML form on another site can't send. Bodies over 25 MB get 413; malformed JSON gets 400.
  • Can't be framed. X-Frame-Options: DENY and frame-ancestors 'none'.
  • Strict headers. Same-origin CSP with no inline scripts, nosniff, Referrer-Policy: no-referrer, same-origin opener and resource policies.
  • Secrets stay put. Stored chmod 600 on disk, shown masked in the UI, never sent back to the browser in full. Static files are path-traversal guarded.

If you want it beyond localhost (e.g. a home server), put it behind your own authenticated reverse proxy and allow its host name. OpenLeads deliberately ships no login because it's built to run on the machine you're sitting at.