How garibudimanoj-ops/crowdwisdom-hermes-ads works
CrowdWisdomTrading Video Ads Agent is a multi-agent pipeline that turns advertising examples and audience research into a reviewed, cinematic short-form ad. The main workflow runs from ad collection and marketing analysis through research, CrowdWisdom-specific data, concept writing, creative review, cinematography, asset/shot planning, and video rendering; orchestration also tracks stage status and quality. The graph preserves README-documented capabilities even where source was not sampled. Relationships without sampled caller evidence are cited to the README; unsampled implementation details are not inferred.
Main entry points: orchestrator.py Stage orchestrator · marketing_analyzer.py Marketing analysis · research_agent.py Audience research · script_agent.py Concept writing
Components 25
Pipeline orchestration
- Stage orchestrator
src/orchestrator.py
Creative agents
- Ads collection
src/agents/ads_manager.py - Marketing analysis
src/agents/marketing_analyzer.py - Audience research
src/agents/research_agent.py - CrowdWisdom data
src/agents/data_agent.py - Concept writing
src/agents/script_agent.py - Creative review
src/agents/creative_director.py - Cinematic planning
src/agents/cinematography_agent.py - Video production
src/agents/video_agent.py - Video quality review
src/agents/quality_agent.py
Integrations
- Visual asset selection
src/integrations/pexels_client.py - Apify
src/integrations/apify_client.py - Tavily search
src/integrations/tavily_tool.py - Exa search
src/integrations/exa_tool.py - Hermes runner
src/integrations/hermes_runner.py - Hermes Python backend
src/integrations/hermes_python_backend.py
Models and status
- Cinematography schema
src/schemas/cinematography_plan.py - Ad and creative models
src/models/ad_models.py - Pipeline status
src/status/pipeline_status.py
Other components
- Pipeline operator
- Apify service
- Tavily / Exa
- Hermes / OpenRouter
- OpenMontage / Remotion
- Final video ad
Connections 35
- Pipeline operator → Stage orchestrator: runs pipeline
README.md - Stage orchestrator → Ads collection: runs stage
src/orchestrator.py - Stage orchestrator → Marketing analysis: runs stage
src/orchestrator.py - Stage orchestrator → Audience research: runs stage
src/orchestrator.py - Stage orchestrator → CrowdWisdom data: runs stage
src/orchestrator.py - Stage orchestrator → Concept writing: runs stage
src/orchestrator.py - Stage orchestrator → Creative review: runs stage
src/orchestrator.py - Stage orchestrator → Video production: runs stage
src/orchestrator.py - Stage orchestrator → Video quality review: runs stage
src/orchestrator.py - Stage orchestrator → Pipeline status: updates status
src/orchestrator.py - Ads collection → Apify: calls
src/agents/ads_manager.py - Apify → Apify service: fetches ads
src/integrations/apify_client.py - Ads collection → Marketing analysis: provides ads
README.md - Marketing analysis → Audience research: provides insights
src/agents/research_agent.py - Audience research → Tavily search: searches with
src/agents/research_agent.py - Audience research → Exa search: searches with
src/agents/research_agent.py - Tavily search → Tavily / Exa: queries
src/integrations/tavily_tool.py - Exa search → Tavily / Exa: queries
src/integrations/exa_tool.py - Marketing analysis → Hermes runner: generates analysis
src/agents/marketing_analyzer.py - Concept writing → Hermes runner: generates concepts
src/agents/script_agent.py - Creative review → Hermes runner: reviews concepts
src/agents/creative_director.py - Hermes runner → Hermes Python backend: delegates to
src/integrations/hermes_runner.py - Hermes runner → Hermes / OpenRouter: sends prompts
README.md - Audience research → Concept writing: provides findings
README.md - CrowdWisdom data → Concept writing: provides brand data
README.md - Concept writing → Creative review: submits concepts
README.md - Creative review → Cinematic planning: provides direction
README.md - Cinematic planning → Cinematography schema: validates plan
src/agents/cinematography_agent.py - Cinematic planning → Visual asset selection: guides selection
README.md - Visual asset selection → Video production: provides footage
README.md - Video production → OpenMontage / Remotion: composes video
README.md - Video production → Final video ad: produces
README.md - Video quality review → Video production: checks output
src/agents/quality_agent.py - Ads collection → Ad and creative models: normalizes records
src/agents/ads_manager.py - Marketing analysis → Ad and creative models: uses insight models
src/agents/marketing_analyzer.py