---
title: "Deploy space-agent"
description: "The agent that re-shapes the Space"
category: "AI/ML"
url: https://railway.com/deploy/space-agent
---

# Deploy space-agent

The agent that re-shapes the Space

**[Deploy space-agent on Railway](https://railway.com/template/space-agent)**

- **Creator:** TeckniX's Projects
- **Category:** AI/ML
- **Total deploys:** 1

## Template content

### space-agent https://github.com/agent0ai/space-agent/raw/main/packaging/resources/icons/source/space-agent-icon-256.webp

- **Source:** https://github.com/TeckniX/space-agent
- **Health check:** /
- **Public domain:** Yes

## Documentation

# Deploy and Host space-agent on Railway

This guide provides instructions on how to deploy and host **space-agent** on [Railway](https://railway.app/). Space-agent is a browser-first AI agent runtime designed to reshape interfaces and build tools directly within your workspace.

[![Space Agent banner](https://raw.githubusercontent.com/TeckniX/space-agent/refs/heads/main/.github/readme-banner-thin.webp)](https://space-agent.ai)

## Deployment Steps

### 1. Use the Railway Template
The fastest way to deploy is using the pre-configured template:

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/qVnMIg?referralCode=HhsRaZ&utm_medium=integration&utm_source=template&utm_campaign=generic)

### 2. Or Deploy from Source
1. Go to your [Railway Dashboard](https://railway.app/dashboard).
2. Click **+ New Project** and select **Deploy from GitHub repo**.
3. Choose your fork of the `space-agent` repository.
4. Railway will automatically detect the build requirements from the repository's `package.json`.

### 3. Deployment Configuration
Once you click **Deploy**, Railway will build the container image. 
- **Port:** Ensure the `PORT` variable is set (default is usually `3000`).
- **Start Command:** The default production command is `node space supervise HOST=0.0.0.0 PORT=$PORT`.

## Troubleshooting
- **Build Failures:** Check the `View Logs` tab. Ensure all dependencies in `package.json` are resolving.
- **Connectivity:** If the browser agent cannot reach external APIs, verify your LLM API keys in the Railway Variables tab.

Please [open an issue](https://github.com/agent0ai/space-agent/issues) if you cannot get it working and tag @TeckniX.

## Common Use Cases
- **Dynamic Interface Building:** Ask the agent to build widgets or workflows directly into the running workspace.
- **Hierarchical Multi-User Systems:** Organize agents into layers for personal work or group sharing.
- **Autonomous Maintenance:** Use the agent to maintain its own documentation and codebase via `AGENTS.md` instruction systems.

### Deployment Dependencies
- A [Railway](https://railway.app/) account.
- API Keys for your chosen LLM providers (OpenAI, Anthropic, or Google Gemini).
- (Optional) A GitHub account for forking the repository.

### Dependencies for Space-Agent Deployment
Railway handles the core environment, but the runtime relies on:
- **Browser Runtime:** The primary agent logic lives in the frontend layer.

## About Hosting
Railway provides a singular platform to host your infrastructure stack. By hosting Space-Agent on Railway, you leverage a persistent environment where the Node.js backend serves as thin infrastructure for:
- Outbound fetch proxying to bypass CORS limits.
- Managing server-owned APIs and infrastructure contracts.
- Persistent admin modes and Git-backed history for "time travel" rollbacks.

### Why Deploy Space-Agent 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 Space-Agent 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.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/space-agent