How anhsirksai/luma-connects works
Luma Connects turns a Luma event URL into an analyzed attendee shortlist: the web app starts and tracks a backend run, which ingests event and public-web evidence, classifies people, and exposes a room snapshot and natural-language chat. The graph also retains documented login, messaging/payment webhook, and CLI capabilities. Some pipeline and integration internals are unsampled; edges below are limited to README statements, visible excerpts, or SOURCE INDEX references.
Main entry points: pipeline.py Analysis pipeline · routes_events.py Event routes · app.py FastAPI service · routes_chat.py Chat routes
Components 28
Web interface
- Next.js app
invite_viewer/app/events/page.tsx - Event detail
invite_viewer/app/events/[id]/page.tsx - Chat and cards
invite_viewer/app/components/event/ConnectorChat.tsx - API client
invite_viewer/app/lib/api.ts - API shapes
invite_viewer/app/lib/api-shape.ts
API and access
- FastAPI service
src/invite_finder/api/app.py - Event routes
src/invite_finder/api/routes_events.py - Chat routes
src/invite_finder/api/routes_chat.py - Run progress routes
src/invite_finder/api/routes_runs.py - Login routes
src/invite_finder/api/routes_auth.py - Webhook routes
src/invite_finder/api/routes_webhooks.py - Discovery CLI
src/invite_finder/cli.py
Event research
- Analysis pipeline
src/invite_finder/pipeline.py - Luma ingestion
src/invite_finder/luma.py - Web discovery agent
src/invite_finder/agent.py - Bright Data APIs
src/invite_finder/brightdata.py
People and insights
- People classification
src/invite_finder/classify.py - Room snapshot
src/invite_finder/snapshot.py - Chat assistant
src/invite_finder/chat.py
Persistence and integrations
- SQLite database
src/invite_finder/db.py - Event records
src/invite_finder/store/event_store.py - People records
src/invite_finder/store/people_store.py - Run records
src/invite_finder/store/run_store.py - Response cache
src/invite_finder/cache.py - Auth records
src/invite_finder/store/auth_store.py - Linq messaging
src/invite_finder/linq.py - Commerce records
src/invite_finder/store/commerce_store.py
Other components
- Event researcher
Connections 39
- Event researcher → Next.js app: submits URL
README.md - Next.js app → API client: starts run
invite_viewer/app/events/page.tsx - API client → API shapes: normalizes data
invite_viewer/app/lib/api.ts - API client → FastAPI service: calls API
README.md - FastAPI service → Event routes: registers routes
src/invite_finder/api/app.py - FastAPI service → Chat routes: registers routes
src/invite_finder/api/app.py - FastAPI service → Run progress routes: registers routes
src/invite_finder/api/app.py - FastAPI service → Login routes: registers routes
src/invite_finder/api/app.py - FastAPI service → Webhook routes: registers routes
src/invite_finder/api/app.py - Event routes → Analysis pipeline: starts analysis
src/invite_finder/api/routes_events.py - Analysis pipeline → Luma ingestion: fetches event
src/invite_finder/pipeline.py - Analysis pipeline → Web discovery agent: discovers profiles
src/invite_finder/pipeline.py - Web discovery agent → Bright Data APIs: searches and fetches
README.md - Luma ingestion → Bright Data APIs: fetches page
README.md - Analysis pipeline → People classification: classifies people
src/invite_finder/pipeline.py - Analysis pipeline → Room snapshot: computes snapshot
src/invite_finder/pipeline.py - Analysis pipeline → Event records: uses records
src/invite_finder/pipeline.py - Analysis pipeline → People records: uses records
src/invite_finder/pipeline.py - Analysis pipeline → Run records: updates status
src/invite_finder/pipeline.py - Event routes → Event records: reads events
src/invite_finder/api/routes_events.py - Event routes → People records: reads people
src/invite_finder/api/routes_events.py - Event routes → Run records: reads runs
src/invite_finder/api/routes_events.py - Event routes → Room snapshot: builds snapshot
src/invite_finder/api/routes_events.py - Run progress routes → Run records: streams events
src/invite_finder/api/routes_runs.py - Chat routes → Chat assistant: answers query
src/invite_finder/api/routes_chat.py - Chat routes → Event records: checks event
src/invite_finder/api/routes_chat.py - Chat routes → People records: checks people
src/invite_finder/api/routes_chat.py - Chat assistant → Chat and cards: returns cards
README.md - Run progress routes → Event detail: streams progress
invite_viewer/app/events/[id]/page.tsx - Event routes → Event detail: serves event data
invite_viewer/app/events/[id]/page.tsx - Login routes → Auth records: manages sessions
src/invite_finder/api/routes_auth.py - Login routes → Linq messaging: sends passcode
src/invite_finder/api/routes_auth.py - Webhook routes → Commerce records: settles payment
src/invite_finder/api/routes_webhooks.py - Webhook routes → Linq messaging: handles messages
src/invite_finder/api/routes_webhooks.py - Discovery CLI → Web discovery agent: runs discovery
README.md - Event records → SQLite database: persists data
- People records → SQLite database: persists data
- Run records → SQLite database: persists data
- Response cache → Bright Data APIs: caches responses