How kishoreaarya/arya-os-v2 works
Arya OS is a content-generation backend with a browser-based creator interface and a broader workflow pipeline intended to be orchestrated by n8n. The creator UI submits image/video generation requests and polls job status; the documented pipeline spans trend discovery, content and media creation, approval, publishing, analytics, and learning. The graph also shows execution/provider selection and workflow state as internal layers. Several substantial routes and agents are unsampled, so their capabilities are represented by subsystem nodes without speculative call paths.
Main entry points: orchestrator.py Workflow orchestration · pipeline_state.py Workflow state · execution_engine.py Execution engine · main.py FastAPI app
Components 25
Creator interface
- Creator UI
frontend/src/App.tsx - Creator API client
frontend/src/api/creatorApi.ts
API and workflow access
- FastAPI app
backend/app/main.py - Creator routes
backend/app/api/routers/creator.py - Research routes
backend/app/api/routers/research.py
Content pipeline
- Trend discovery
backend/app/services/trend_sources/service.py - Trend sources
backend/app/services/trend_sources - Workflow state
backend/app/services/pipeline_state.py - Workflow orchestration
backend/app/workflows/orchestrator.py - Shot execution
backend/app/workflows/shot_executor.py - Video assembly
backend/app/workflows/video_assembler.py - Content agents
backend/app/agents - Approval and publishing
backend/app/api/routers/approvals.py - Analytics and learning
backend/app/api/routers/analytics.py
Generation execution
- Execution engine
backend/app/services/execution_engine.py - Decision engine
backend/app/services/decision_engine.py - Provider routing
backend/app/providers/router.py - Provider adapters
backend/app/providers - Output validators
backend/app/validators
State and learning
- Workflow records
backend/app/models/core.py - Database session
backend/app/database/session.py - Asset storage
backend/app/storage - Event log
backend/app/events/log.py
Other components
- Creator
- n8n
Connections 25
- Creator → Creator UI: uses
- Creator UI → Creator API client: requests
frontend/src/App.tsx - Creator API client → Creator routes: calls HTTP
frontend/src/api/creatorApi.ts - FastAPI app → Creator routes: registers
backend/app/main.py - FastAPI app → Research routes: registers
backend/app/main.py - Research routes → Trend discovery: calls
backend/app/api/routers/research.py - Trend discovery → Trend sources: queries
backend/app/services/trend_sources/service.py - n8n → FastAPI app: calls services
README.md - n8n → Workflow state: resumes pipeline
backend/app/services/pipeline_state.py - n8n → Workflow state: advances stages
backend/app/services/pipeline_state.py - Workflow orchestration → Shot execution: dispatches
backend/app/workflows/orchestrator.py - Workflow orchestration → Video assembly: assembles
backend/app/workflows/orchestrator.py - Workflow orchestration → Output validators: validates video
backend/app/workflows/orchestrator.py - Workflow orchestration → Content agents: uses music agent
backend/app/workflows/orchestrator.py - n8n → Content agents: orchestrates stages
README.md - n8n → Approval and publishing: requests decisions
README.md - n8n → Analytics and learning: runs learning loop
README.md - Execution engine → Decision engine: decides retries
backend/app/services/execution_engine.py - Execution engine → Provider routing: executes calls
backend/app/services/execution_engine.py - Execution engine → Output validators: validates output
backend/app/services/execution_engine.py - Provider routing → Provider adapters: routes requests
backend/app/providers/router.py - Workflow state → Workflow records: updates stage
backend/app/services/pipeline_state.py - Workflow state → Event log: records transitions
backend/app/services/pipeline_state.py - Workflow orchestration → Asset storage: uses storage
backend/app/workflows/orchestrator.py - Database session → Workflow records: provides sessions