---
title: "Deploy Super Agent Party"
description: "Self-hosted AI agent & companion with MCP, RAG, tools and login gateway"
category: "AI/ML"
url: https://railway.com/deploy/super-agent-party
---

# Deploy Super Agent Party

Self-hosted AI agent & companion with MCP, RAG, tools and login gateway

**[Deploy Super Agent Party on Railway](https://railway.com/template/super-agent-party)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/super-agent-party/manifest.json

- **Creator:** My Projects
- **Category:** AI/ML

## Template content

### backend https://raw.githubusercontent.com/heshengtao/super-agent-party/main/static/source/icon.png

- **Image:** ailm32442/super-agent-party:latest

### gateway https://raw.githubusercontent.com/devicons/devicon/master/icons/nginx/nginx-original.svg

- **Image:** ailm32442/nginx-for-sap:latest
- **Start command:** `/bin/sh -c "sed -i \"s/server backend:3456/server $BACKEND_HOST:3456/\" /etc/nginx/nginx.conf && exec /docker-entrypoint.sh /start.sh"`
- **Public domain:** Yes

## Documentation

# Deploy and Host Super Agent Party on Railway

[Super Agent Party](https://github.com/heshengtao/super-agent-party) is an all-in-one, self-hosted AI companion and agent platform: chat with any LLM, give agents tools (MCP servers, web search, code execution, knowledge bases/RAG), schedule autonomous tasks, run a Live2D/VRM desktop-pet style companion, and connect it to bots and streaming platforms.

## About Hosting Super Agent Party

This template deploys the official Docker setup, adapted for Railway:

| Service | Image | Purpose |
|---|---|---|
| **backend** | `ailm32442/super-agent-party` | The Super Agent Party app (port 3456, private only). Persistent volume at `/app/data` stores the SQLite DB, settings, knowledge bases and logs |
| **gateway** | `ailm32442/nginx-for-sap` | Public entry point: nginx + login/auth service with captcha. Persistent volume at `/data` keeps password changes |

The backend is **never exposed publicly** — every request goes through the authenticated gateway over Railway's private network.

**After deploy:**
1. Open the **gateway** domain.
2. Log in with username `admin` and the password from the gateway service's `INIT_PASS` variable (generated randomly for your deployment).
3. Change the password in the UI, then add your model provider (OpenAI, Anthropic, Gemini, DeepSeek, Ollama, any OpenAI-compatible API…) in Settings.

## Common Use Cases

- Personal AI assistant with tools, MCP servers, memory and knowledge bases
- AI companion / VTuber-style character with Live2D or VRM avatars and TTS
- Scheduled autonomous agent tasks and bot integrations (QQ, Discord, Telegram, live streaming)
- A private, multi-model chat workspace you can reach from any device

## Dependencies for Super Agent Party Hosting

- Docker images `ailm32442/super-agent-party` and `ailm32442/nginx-for-sap`
- An API key for at least one LLM provider (configured in the UI after login)

### Deployment Dependencies

- Source: https://github.com/heshengtao/super-agent-party
- Official Docker Compose: https://github.com/heshengtao/super-agent-party/blob/main/docker-compose.yml

### Implementation Details

The gateway's nginx config hard-codes the upstream `backend:3456`; the template's start command rewrites it to the backend's Railway private domain (`BACKEND_HOST`) at boot. Gateway variables: `INIT_USER`, `INIT_PASS` (initial credentials), `JWT_SECRET` (session signing, generated), and optional `FORCE_RESET=true` to reset the admin password to `INIT_PASS` on next start.

## Why Deploy Super Agent Party 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 Super Agent Party 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.


## 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 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/super-agent-party