How yadnesh72/cybba-segment-automation works
Cybba Segment Automation is a full-stack tool for finding marketplace audience-segment gaps and producing submission-ready segment names, taxonomy, descriptions, and pricing. A user starts a feature-configurable run in the web app; the backend streams progress and rows, while the pipeline generates proposals, validates them, and enriches them before results can be explored, persisted, or downloaded. Separate UI branches provide comparison, suggestions, and analytics. The graph follows documented capabilities and indexed imports; several backend internals and routes were not excerpted, so uncertain call links are omitted.
Main entry points: api.py FastAPI routes · pipeline.py Run orchestration · api.ts API client · App.tsx Run and results UI
Components 20
Web application
- Run and results UI
frontend/src/App.tsx - API client
frontend/src/api.ts - Segments table
frontend/components/SegmentsTable.tsx - Comparison page
frontend/components/ComparisonPage.tsx - Suggestions page
frontend/components/SuggestionsPage.tsx - Analytics page
frontend/components/AnalyticsPage.tsx
Generation pipeline
- FastAPI routes
backend/api.py - Run orchestration
backend/src/pipeline.py - Gap proposal model
backend/src/segment_expansion_model.py
Enrichment and validation
- Proposal validation
backend/src/validators.py - Taxonomy prediction
backend/src/taxonomy_bundle.py - Description generation
backend/src/llm_descriptions.py - Pricing inference
backend/src/pricing_model.py
Exploration and persistence
- Catalog comparison
backend/src/comparison.py - Gap suggestions
backend/src/suggestions.py - Run analytics
backend/src/analytics.py - Analytics analysis
backend/src/llm_analytics.py - Run persistence
backend/src/persist.py
Other components
- Platform user
- Ollama service
Connections 23
- Platform user → Run and results UI: starts runs
README.md - Run and results UI → API client: requests and streams
frontend/src/App.tsx - Run and results UI → Segments table: renders rows
frontend/src/App.tsx - API client → FastAPI routes: calls endpoints
frontend/src/api.ts - FastAPI routes → Run orchestration: runs pipeline
backend/api.py - Run orchestration → Gap proposal model: generates proposals
backend/src/pipeline.py - Run orchestration → Proposal validation: validates proposals
backend/src/pipeline.py - Run orchestration → Taxonomy prediction: predicts taxonomy
backend/src/pipeline.py - Run orchestration → Description generation: generates descriptions
backend/src/pipeline.py - Run orchestration → Pricing inference: infers prices
backend/src/pipeline.py - Description generation → Ollama service: requests generation
backend/src/llm_descriptions.py - FastAPI routes → Run persistence: stores run data
backend/api.py - API client → Comparison page: serves results
frontend/src/App.tsx - Comparison page → FastAPI routes: fetches matches
frontend/components/ComparisonPage.tsx - API client → Suggestions page: serves suggestions
frontend/src/App.tsx - Suggestions page → API client: requests analysis
frontend/components/SuggestionsPage.tsx - FastAPI routes → Gap suggestions: routes requests
backend/api.py - Gap suggestions → Run orchestration: uses run results
backend/src/suggestions.py - API client → Analytics page: serves analytics
frontend/src/App.tsx - Analytics page → FastAPI routes: requests analytics
frontend/components/AnalyticsPage.tsx - FastAPI routes → Run analytics: routes analytics
backend/api.py - Run analytics → Analytics analysis: delegates analysis
backend/src/analytics.py - FastAPI routes → Catalog comparison: routes catalog search
backend/api.py