Orion¶

Platform Architecture¶

Orion is a distributed system of nine components communicating through a central Redis event bus. External trend data flows in through Scout, gets orchestrated by Director via LangGraph, rendered by Media and Editor, and published by Publisher — all coordinated through event-driven pub/sub.

graph TB
    subgraph External["External Sources"]
        RSS[":material-rss: RSS Feeds"]
        GT["Google Trends"]
        TW["Twitter/X API"]
    end

    subgraph Gateway["Go Gateway :8000"]
        GW["Chi Router + JWT Auth"]
        WS["WebSocket Hub"]
        RL["Rate Limiter"]
    end

    subgraph Services["Python FastAPI Services"]
        SC["Scout :8001\nTrend Detection"]
        DR["Director :8002\nPipeline Orchestration"]
        MD["Media :8003\nImage Generation"]
        ED["Editor :8004\nVideo Rendering"]
        PL["Pulse :8005\nAnalytics"]
        PB["Publisher :8006\nSocial Publishing"]
        ID["Identity :8007\nUser Management"]
    end

    subgraph AI["AI Infrastructure"]
        OL["Ollama\nLLM Inference"]
        CU["ComfyUI\nImage Generation"]
        LG["LangGraph\nPipeline State"]
    end

    subgraph Data["Data Layer"]
        PG[("PostgreSQL 17")]
        RD[("Redis 7.4")]
        MV[("Milvus 2.4")]
    end

    subgraph Frontend["Frontend"]
        DB["Next.js Dashboard :3001"]
        CLI["Python CLI"]
    end

    RSS --> SC
    GT --> SC
    TW --> SC

    CLI --> GW
    DB --> GW
    GW --> SC & DR & MD & ED & PL & PB & ID
    WS --> RD

    SC -->|"orion.trend.detected"| RD
    RD -->|"event"| DR
    DR -->|"orion.content.created"| RD
    RD -->|"event"| MD
    MD -->|"orion.media.generated"| RD
    RD -->|"event"| ED

    DR --> OL
    DR --> LG
    DR --> MV
    MD --> CU
    ED --> OL

    SC & DR & MD & ED & PL & PB & ID --> PG
    SC & DR & MD & ED & PL & PB --> RD

Services Overview¶

Guides & Tutorials¶

Visual walkthroughs with screenshots for every part of the platform.

See all guides

Tech Stack¶

Quick Commands¶

Build and run¶

# Build the Go gateway binary
make build

# Run the gateway locally (port 8000)
make run

# Start all services with Docker Compose
docker compose -f deploy/docker-compose.yml up -d

# Start in development mode with hot reload
docker compose -f deploy/docker-compose.yml -f deploy/docker-compose.dev.yml up

# Start with GPU services (Ollama + ComfyUI)
docker compose -f deploy/docker-compose.yml --profile full up -d

Test and lint¶

# Run all tests (Go + Python + CLI + Dashboard)
make test-all

# Run all Go tests
make test

# Run Go linter
make lint

# Run Python tests for a specific service
cd services/scout && uv run pytest

# Run dashboard tests
cd dashboard && npm test

# Run all linters
make check

CLI usage¶

The CLI is a Python/Typer tool. Install via cd cli && uv sync.

# Authenticate with the gateway
orion auth login

# Check system health
orion system health

# Show system status (mode, GPU, queue depth)
orion system status

# Trigger a trend scan
orion scout trigger

# List detected trends
orion scout list-trends

# List content items
orion content list

# Approve content for publishing
orion content approve <content-id>

# Run CLI tests and linting
make cli-test
make cli-lint

Dashboard Preview¶

The Orion dashboard provides a glassmorphism-styled admin interface for managing the entire content pipeline.

See the Dashboard Tour for a complete walkthrough of every page.

Quick Links¶

• Installation — Set up the full development environment
• Quickstart — Run Orion and trigger your first pipeline in 5 minutes
• API Reference — Full REST endpoint documentation
• Docker Deployment — Container orchestration and production setup
• LangGraph Pipeline — Content creation graph with HITL gates
• Configuration — Environment variables and service settings
• Monitoring — Prometheus, Grafana, and alerting
• Guides & Tutorials — Visual walkthroughs with screenshots
• Dashboard Tour — See every page of the admin dashboard