Deploy OpenMAIC

Multi-agent AI classroom: turn a topic or document into an AI-taught lesson

Deploy OpenMAIC

/var/lib/postgresql/data

/app/data

Deploy and Host OpenMAIC on Railway

OpenMAIC (Open Multi-Agent Interactive Classroom) is an open-source AI learning platform from Tsinghua University's MAIC team. Give it a topic or a document and a team of AI agents builds a full lesson: slides, narration, quizzes, interactive simulations and project-based activities, then teaches it with an AI teacher and AI classmates.

About Hosting OpenMAIC

This template runs OpenMAIC 1.4.2 as one web service with Railway's PostgreSQL. Courses, folders, chat history and generated media live in Postgres. Uploaded materials, classroom media, usage records and the instance key live on a volume at /app/data, so both survive redeploys. The site is locked with a generated access code: find ACCESS_CODE in the OpenMAIC service's Variables tab, open the public URL and enter it. Then add an AI provider key (OpenAI, Anthropic, Google, DeepSeek, Ollama and others) under Settings, Model Services. Saved keys are encrypted with the generated OPENMAIC_SECRET_KEY. The service builds from a public GitHub repo, so version bumps reach you as Railway update notices.

Common Use Cases

  • Turn a topic, PDF or lecture notes into an interactive lesson with slides and quizzes
  • Run a private AI tutor for a class, a study group or a training team
  • Try multi-agent teaching with your own model provider keys or an OpenAI-compatible endpoint you host

Dependencies for OpenMAIC Hosting

  • OpenMAIC 1.4.2, built from the upstream release tag by this template's GitHub repo
  • PostgreSQL (Railway's managed database, private network only)
  • An API key for at least one AI model provider, added in the app after deploy

Deployment Dependencies

Implementation Details

The app runs in single-user mode, like upstream's Docker Compose setup: everyone who enters the access code shares one course library, so treat the code as a team password and change it in Variables if it leaks. The start script refuses to boot with an empty ACCESS_CODE. Access-code attempts are rate limited per visitor (10 per minute) using Railway's forwarded client address. The health check is /api/health. To update, apply Railway's update notice after reading the repo's CHANGELOG.md, and back up Postgres together with OPENMAIC_SECRET_KEY first: newer releases can migrate the database. Optional extras such as web search, image or video generation and text-to-speech are configured in Settings or with the variables in upstream's .env.example; MP4 video export needs a separate render service and is not included.

Why Deploy OpenMAIC on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying OpenMAIC on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
Chat Chat
Chat Chat, your own unified chat and search to AI platform.

okisdev
117
View Template
Weaviate
Vector database with hybrid search and an API key-protected API

GitHub Locker
1
View Template
Möbius Personal AI OS
Self-hosted AI agent that builds and runs apps for you, with memory.

bento
1