---
title: "Deploy OpenMAIC"
description: "AI classroom for any topic: slides, narration, quizzes. Your access code."
category: "AI/ML"
url: https://railway.com/deploy/openmaic-2
---

# Deploy OpenMAIC

AI classroom for any topic: slides, narration, quizzes. Your access code.

**[Deploy OpenMAIC on Railway](https://railway.com/template/openmaic-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/openmaic-2/manifest.json

- **Creator:** AvgSoft
- **Category:** AI/ML

## Template content

### openmaic https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@b801a64/service-icons/openmaic.svg

- **Source:** https://github.com/mikedepo/OpenMAIC
- **Start command:** `/bin/sh -c "echo IyEvYmluL3NoCiMgU3RhcnQgT3Blbk1BSUMgb24gUmFpbHdheS4gUnVucyBhcyByb290IChSQUlMV0FZX1JVTl9VSUQ9MCkgc28gaXQgY2FuIHRha2UgdGhlCiMgdm9sdW1lIGF0IC9hcHAvZGF0YSwgd2hpY2ggUmFpbHdheSBjcmVhdGVzIG93bmVkIGJ5IHJvb3QsIHRoZW4gZHJvcHMgdG8gdGhlCiMgaW1hZ2UncyBvd24gbmV4dGpzIHVzZXIgKHVpZCAxMDAxKSB0byBydW4gdGhlIHNlcnZlci4KIyBUaGUgdGVtcGxhdGUncyBzdGFydCBjb21tYW5kIGlzIHRoaXMgZmlsZSBiYXNlNjQtZW5jb2RlZCAoc2VlIHRlbXBsYXRlLm1kIGZvcgojIGhvdyB0byByZWJ1aWxkIGl0KS4KCiMgT3Blbk1BSUMgcmVmdXNlcyB0byBzdGFydCB3aGVuIEFDQ0VTU19DT0RFIGlzIG91dHNpZGUgW0EtWmEtejAtOS5fLV17MSwxMjh9LgojIEEgZmFpbGVkIGRlcGxveSBpcyB3b3JzZSBmb3IgdGhlIG93bmVyIHRoYW4gdGhlIHNhbWUgY29kZSB3aXRoIHRoZSBzdHJheQojIGNoYXJhY3RlcnMgcmVtb3ZlZCwgc28gY2xlYW4gaXQgYW5kIHNheSB3aGF0IGhhcHBlbmVkLiBUaGUgY29kZSBpdHNlbGYgaXMKIyBuZXZlciBwcmludGVkLgpDT0RFPSQocHJpbnRmICVzICIke0FDQ0VTU19DT0RFOi19IiB8IHRyIC1jZCAnQS1aYS16MC05Ll8tJyB8IGN1dCAtYzEtMTI4KQppZiBbIC16ICIkQ09ERSIgXTsgdGhlbgogIENPREU9JCh0ciAtY2QgJ2EtekEtWjAtOScgPCAvZGV2L3VyYW5kb20gfCBoZWFkIC1jIDI0KQogIGVjaG8gIltzZXR1cF0gQUNDRVNTX0NPREUgd2FzIGVtcHR5IG9yIGhhZCBubyB1c2FibGUgY2hhcmFjdGVycy4gQSByYW5kb20gb25lIHdhcyBnZW5lcmF0ZWQsIHNvIG5vYm9keSBjYW4gb3BlbiB0aGlzIGRlcGxveW1lbnQgeWV0OiBzZXQgQUNDRVNTX0NPREUgaW4gdGhlIFZhcmlhYmxlcyB0YWIgYW5kIHJlZGVwbG95LiIKZWxpZiBbICIkQ09ERSIgIT0gIiRBQ0NFU1NfQ09ERSIgXTsgdGhlbgogIGVjaG8gIltzZXR1cF0gQUNDRVNTX0NPREUgaGVsZCBjaGFyYWN0ZXJzIE9wZW5NQUlDIHJlamVjdHMsIGFuZCB0aGV5IHdlcmUgcmVtb3ZlZC4gQWxsb3dlZDogbGV0dGVycywgZGlnaXRzLCBkb3QsIHVuZGVyc2NvcmUgYW5kIGh5cGhlbi4iCmZpCmV4cG9ydCBBQ0NFU1NfQ09ERT0iJENPREUiCgojIEEgbmV3IFJhaWx3YXkgdm9sdW1lIGlzIG93bmVkIGJ5IHJvb3QgYW5kIGhvbGRzIGxvc3QrZm91bmQsIGJ1dCB0aGUgc2VydmVyCiMgd3JpdGVzIHVwbG9hZGVkIG1hdGVyaWFscyBhbmQgaXRzIGluc3RhbmNlIGtleSBoZXJlIGFzIG5leHRqcy4Kcm1kaXIgL2FwcC9kYXRhL2xvc3QrZm91bmQgMj4vZGV2L251bGwKY2hvd24gLVIgbmV4dGpzOm5vZGVqcyAvYXBwL2RhdGEKCmV4ZWMgc3UgbmV4dGpzIC1zIC9iaW4vc2ggLWMgJ25vZGUgc2VydmVyLmpzJwo= | base64 -d > /tmp/start.sh && exec sh /tmp/start.sh"`
- **Health check:** /api/health
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host OpenMAIC on Railway

OpenMAIC is an AI classroom: give it a topic and its agents write the lesson, the slides and the quizzes, then teach it. This template adds the PostgreSQL it needs and an access code.

![OpenMAIC: an AI classroom that teaches the lesson it wrote](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@b801a64/openmaic/banner.png)

## About Hosting OpenMAIC

You get OpenMAIC 1.4.1 on its own private Postgres, which keeps your courses and learner progress. Choose an access code on the deploy form, open the URL and type it in, then connect a model in Settings.

## Common Use Cases

- Build a course from one topic
- Teach a class online
- Turn notes into slides

## Dependencies for OpenMAIC Hosting

- OpenMAIC
- PostgreSQL
- Volume at /app/data

### Deployment Dependencies

- [OpenMAIC repository](https://github.com/THU-MAIC/OpenMAIC)
- [Hosting guide](https://github.com/THU-MAIC/OpenMAIC/blob/main/packages/docs/content/docs/hosting.mdx)

### Implementation Details

![OpenMAIC architecture: the classroom public, Postgres private](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@b801a64/openmaic/architecture.png)

Back up the database and keep a copy of `OPENMAIC_SECRET_KEY`: the provider keys you save cannot be read without it. Everyone with the access code shares one library, so it is a team password, not a login. Both services idle near 0.2 GB, within the Free plan.

## 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.

**Updated 2026-11-06:** first release, OpenMAIC 1.4.1.


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius v0.1 Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

Open this page in a browser: https://railway.com/deploy/openmaic-2