Deploy and Host space-agent on Railway

This guide provides instructions on how to deploy and host space-agent on Railway. Space-agent is a browser-first AI agent runtime designed to reshape interfaces and build tools directly within your workspace.

Deployment Steps

1. Use the Railway Template

The fastest way to deploy is using the pre-configured template:

2. Or Deploy from Source

1. Go to your Railway 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 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 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.