How kamalchahal7/arrive works
Arrive helps newly arrived immigrants get official information in their language, understand next steps, and reach settlement workers; staff also use anonymized needs data. The main flow runs from newcomer pages through the FastAPI API to answers grounded in ingested official sources, or to household checklist and program guidance. Voice, onboarding, letters, scam checks, staff handoffs, and analytics are additional product branches. The README and sampled backend show the principal integrations; several frontend and backend subsystems are represented from documented capabilities and the source index, without asserting their internal calls.
Main entry points: main.py FastAPI application · ask.py Answer service · ingest.py Source ingestion · [locale] Localized web app
Components 24
Newcomer experience
- Localized web app
frontend/src/app/[locale] - Checklist and programs
frontend/src/app/[locale]/(app)/roadmap/page.tsx - Voice experience
frontend/src/components/VoiceAssistant.tsx
API and domain
- FastAPI application
backend/app/main.py - Ask endpoint
backend/app/routers/ask.py - Answer service
backend/app/services/ask.py - Checklist endpoints
backend/app/routers/checklist.py - Household checklist
backend/app/services/checklist.py - Voice tools
backend/app/routers/voice.py
Official knowledge
- Ingestion scheduler
backend/app/services/ingestion_runner.py - Source ingestion
ingestion/ingest.py - Source retrieval
backend/app/services/retrieval.py - Embedding helpers
backend/app/services/embeddings.py
Staff workflows
- Staff portal
frontend/src/app/(staff)/worker/page.tsx - Insights dashboard
frontend/src/app/(staff)/insights/page.tsx - Worker handoffs
backend/app/services/handoff.py - Needs analytics
backend/app/services/insights.py
External services
- Tiger Data
- Gemini
- ElevenLabs
- Auth0
Other components
- Newcomer
- Settlement staff
- Official web pages
Connections 31
- Newcomer → Localized web app: uses
README.md - Localized web app → FastAPI application: calls API
README.md - FastAPI application → Ask endpoint: routes
backend/app/main.py - Ask endpoint → Answer service: calls
backend/app/routers/ask.py - Answer service → Source retrieval: retrieves sources
- Source retrieval → Embedding helpers: embeds query
backend/app/services/retrieval.py - Embedding helpers → Gemini: requests vectors
backend/app/services/embeddings.py - Source retrieval → Tiger Data: searches passages
README.md - Answer service → Gemini: generates answers
README.md - Localized web app → Checklist and programs: opens
README.md - Checklist and programs → FastAPI application: calls API
- FastAPI application → Checklist endpoints: routes
backend/app/main.py - Checklist endpoints → Household checklist: builds checklist
backend/app/routers/checklist.py - Checklist endpoints → Tiger Data: reads progress
- FastAPI application → Ingestion scheduler: schedules ingestion
backend/app/main.py - Ingestion scheduler → Source ingestion: runs
backend/app/services/ingestion_runner.py - Official web pages → Source ingestion: provides pages
ingestion/ingest.py - Source ingestion → Embedding helpers: embeds chunks
ingestion/ingest.py - Source ingestion → Tiger Data: writes chunks
ingestion/ingest.py - Voice experience → ElevenLabs: connects agent
README.md - ElevenLabs → Voice tools: calls tools
README.md - FastAPI application → Voice tools: routes
backend/app/main.py - Voice tools → Answer service: calls
backend/app/routers/voice.py - Settlement staff → Staff portal: uses
README.md - Settlement staff → Insights dashboard: uses
README.md - Staff portal → Auth0: authenticates
README.md - Staff portal → FastAPI application: calls API
README.md - Insights dashboard → FastAPI application: calls API
README.md - FastAPI application → Worker handoffs: routes handoffs
- FastAPI application → Needs analytics: routes analytics
- Needs analytics → Tiger Data: aggregates activity
README.md