How artasyaskar/opportunityos-ai works
OpportunityOS AI helps users discover and rank global opportunities, build an evidence-backed profile, and prepare tailored applications. The principal workflow runs from profile and document preparation through explainable matching to application drafting and pipeline tracking. The README documents broader research-memory and multi-provider AI capabilities; the sampled sources confirm evidence extraction and AI routing usage, but do not expose every route-to-service connection, so uncertain wiring is omitted.
Main entry points: router.ts AI provider router · vault/page.tsx Knowledge vault · workspace/page.tsx Opportunity workspace · IngestionPipeline.ts Opportunity ingestion
Components 27
Opportunity discovery
- Opportunity dashboard
src/app/dashboard/page.tsx - Opportunity catalog
src/app/opportunities/page.tsx - Opportunity ingestion
src/lib/services/providers/IngestionPipeline.ts - Provider registry
src/lib/services/providers/providerRegistry.ts - Personalized ranking
src/lib/recommendationEngine.ts - Ranking service
src/lib/services/RankingService.ts - Compatibility scoring
src/lib/scoringEngine.ts
Profile and evidence
- Profile onboarding
src/app/onboarding/page.tsx - Profile analysis
src/app/api/profile/analyze/route.ts - Document intake
src/app/api/documents/parse/route.ts - Knowledge vault
src/app/dashboard/vault/page.tsx - Document storage
src/lib/storage/StorageManager.ts - Evidence extraction
src/lib/services/EvidenceEngine.ts - Canonical profile
src/lib/services/ProfileMergeEngine.ts
Application workflow
- Opportunity workspace
src/app/dashboard/opportunities/[id]/workspace/page.tsx - Application agent APIs
src/app/api/agents - Application builder
src/services/ai/agents/applicationBuilderAgent.ts - Evidence review
src/components/EvidenceReview.tsx - Application pipeline
src/components/auth/PipelineContext.tsx - Pipeline service
src/lib/services/PipelineService.ts - Pipeline records
src/lib/repositories/PipelineRepository.ts
AI and platform services
- AI provider router
src/services/ai/router.ts
Other components
- Student or professional
- Gemini
- Groq
- OpenRouter vision
- Firebase Storage
Connections 25
- Student or professional → Opportunity dashboard: explores
- Student or professional → Opportunity catalog: browses
- Opportunity ingestion → Provider registry: selects providers
- Opportunity ingestion → Personalized ranking: supplies opportunities
- Personalized ranking → Ranking service: ranks opportunities
- Ranking service → Compatibility scoring: scores compatibility
- Student or professional → Profile onboarding: creates profile
- Profile onboarding → Profile analysis: submits profile
- Student or professional → Document intake: uploads documents
- Document intake → Knowledge vault: adds documents
- Knowledge vault → Document storage: manages files
- Document storage → Firebase Storage: stores files
- Knowledge vault → Evidence extraction: provides documents
- Evidence extraction → Canonical profile: extracts verified facts
- Student or professional → Opportunity workspace: prepares application
- Opportunity workspace → Application agent APIs: requests assistance
- Application agent APIs → Application builder: dispatches task
- Application builder → AI provider router: generates draft
- AI provider router → Gemini: routes request
- AI provider router → Groq: fails over
- AI provider router → OpenRouter vision: routes vision
- Opportunity workspace → Evidence review: reviews evidence
- Student or professional → Application pipeline: tracks applications
- Application pipeline → Pipeline service: loads and saves
- Pipeline service → Pipeline records: reads and writes