How kishoreaarya/arya-os works
Arya OS is a FastAPI-backed AI content-generation platform with a React creator interface and a broader multi-stage content pipeline. The visible creator workflow submits image/video generation requests, polls job status, and displays generated assets; the pipeline also supports trend research, agent stages, validation, approvals, publishing, analytics, and learning. README and source-index references support several subsystem relationships, but many implementation details were not sampled, so those links are omitted rather than inferred.
Main entry points: orchestrator.py Workflow Orchestrator · models Workflow and Media Records · App.tsx Creator Interface · creatorApi.ts Creator API Client
Components 22
Creator Experience
- Creator Interface
frontend/src/App.tsx - Creator API Client
frontend/src/api/creatorApi.ts - Asset Preview
frontend/src/components/AssetPreview.tsx
API and Workflow
- FastAPI Application
backend/app/main.py - Creator Routes
backend/app/api/routers/creator.py - Research Routes
backend/app/api/routers/research.py - Workflow Orchestrator
backend/app/workflows/orchestrator.py - Pipeline State
backend/app/services/pipeline_state.py - Approval Checkpoints
backend/app/api/routers/approvals.py
Content Production
- Agent Registry
backend/app/agents/registry.py - Stage Execution
backend/app/workflows/stage_executor.py - Shot Execution
backend/app/workflows/shot_executor.py - Video Assembly
backend/app/workflows/video_assembler.py - Output Validators
backend/app/validators
Research and Learning
- Trend Discovery
backend/app/services/trend_sources/service.py - Trend Sources
backend/app/services/trend_sources - Learning Feedback
backend/app/services/learning_analyzer.py
Providers and Records
- Provider Execution
backend/app/services/execution_engine.py - Provider Router
backend/app/providers/router.py - Workflow and Media Records
backend/app/models - Publishing Integrations
backend/app/platforms
Other components
- Creator
Connections 20
- Creator → Creator Interface: uses
- Creator Interface → Creator API Client: submits requests
frontend/src/App.tsx - Creator API Client → Creator Routes: calls generation API
frontend/src/api/creatorApi.ts - Creator Routes → Workflow Orchestrator: starts workflows
- Workflow Orchestrator → Agent Registry: dispatches stages
backend/app/workflows/orchestrator.py - Workflow Orchestrator → Stage Execution: executes stages
backend/app/workflows/orchestrator.py - Workflow Orchestrator → Shot Execution: executes shots
backend/app/workflows/orchestrator.py - Workflow Orchestrator → Video Assembly: assembles video
backend/app/workflows/orchestrator.py - Workflow Orchestrator → Pipeline State: tracks progress
backend/app/workflows/orchestrator.py - Provider Execution → Provider Router: routes calls
backend/app/services/execution_engine.py - Provider Execution → Output Validators: validates output
backend/app/services/execution_engine.py - Research Routes → Trend Discovery: requests trends
backend/app/api/routers/research.py - Trend Discovery → Trend Sources: queries sources
backend/app/services/trend_sources/service.py - Creator Routes → Workflow and Media Records: records generation
- Pipeline State → Workflow and Media Records: updates run state
backend/app/services/pipeline_state.py - Approval Checkpoints → Workflow and Media Records: stores decisions
README.md - Publishing Integrations → Workflow and Media Records: records published output
- Learning Feedback → Workflow and Media Records: uses performance feedback
README.md - Creator Interface → Asset Preview: renders assets
frontend/src/App.tsx - Creator API Client → FastAPI Application: checks health
frontend/src/api/creatorApi.ts