Getting Started¶
Welcome to Orion — the Digital Twin Content Agency. Orion is a distributed platform of autonomous AI agents that detect trending topics, generate written and visual content, and publish it across social media channels — all without manual intervention.
This section walks you through setting up a local development environment, launching the full service stack, running your first content pipeline, and configuring every aspect of the platform.
Roadmap¶
- Installation — Install all prerequisites, clone the repository, and set up each layer of the stack
- Quickstart — Launch all services and trigger your first trend scan through the complete pipeline
- Configuration — Customize environment variables, service settings, rate limits, and AI provider options
- Troubleshooting — Diagnose and resolve common issues with Docker, networking, auth, and builds
Prerequisites¶
| Requirement | Minimum Version | Purpose |
|---|---|---|
| Docker | 24.x | Container runtime for all services |
| Docker Compose | 2.20+ | Multi-container orchestration |
| Go | 1.24 | Gateway development |
| Python | 3.13 | AI microservices and CLI |
| Node.js | 22 LTS | Dashboard frontend |
| uv | latest | Python package management (replaces pip) |
| Make | any | Build automation |
Verify your environment¶
# Check all prerequisites at once
docker --version # Docker 24.x+
docker compose version # Docker Compose 2.20+
go version # go1.24.x
python3 --version # Python 3.13.x
node --version # v22.x.x
uv --version # uv 0.x.x
make --version # GNU Make 4.x
Or use the automated setup script which checks everything for you:
Docker-only setup
If you only need to run Orion (not develop it), Docker and Docker Compose are the only requirements. All services run in containers and no local Go, Python, or Node.js installation is needed.