Deploy and Host OpenMAIC on Railway

About Hosting

OpenMAIC (Open Multi-Agent Interactive Classroom) is an open-source AI learning platform that generates full classroom experiences from a prompt or document input. It combines multi-agent orchestration with scene generation (slides, quizzes, interactive HTML, and project-based activities), plus optional voice and whiteboard-style outputs.

This Railway template deploys OpenMAIC as a single container service using a pre-built Docker image (xiaosong233/openmaic-railway:latest) and exposes it on port 3000. No external database is required by default.

Why Deploy

Self-hosted AI classroom: Keep your learning data and generated content under your own infrastructure.
Fast setup: One service, one public domain, minimal wiring.
Provider flexibility: Supports multiple LLM vendors through environment variables.
Production-ready container: Uses a pre-built, multi-arch Docker image suitable for Railway runtime environments.
Easy template reuse: Ship once and reuse for demos, teams, or educational deployments.

Common Use Cases

Build an internal AI teaching assistant for schools, labs, or training teams.
Generate interactive lessons from course material and PDFs.
Run a private alternative to hosted AI classroom products.
Prototype multi-agent educational workflows with custom LLM provider keys.

Dependencies for Deployment

Deployment Dependencies

Dependency	Details
Docker Image	`xiaosong233/openmaic-railway:latest`
Container Port	`3000`
Persistent Volume	Not required for default deployment
Required Env Vars	`PORT=3000` and at least one LLM provider API key (e.g. `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`)
Optional Env Vars	Provider base URLs/models, TTS/ASR/PDF/Image/Video keys, `DEFAULT_MODEL`
External Services	Optional, depending on provider selection (OpenAI, Anthropic, Google, etc.)