How do I deploy nanobot on Railway?

You can deploy nanobot on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: nanobot-8354c052, or click "Get template help" for this template for more assistance.

Deploy and Host nanobot on Railway

nanobot is an ultra-lightweight personal AI assistant built in just ~4,000 lines of Python. It connects to LLM providers like OpenRouter, Anthropic, OpenAI, or DeepSeek, and integrates with chat platforms including Telegram, WhatsApp, and Feishu. Despite its minimal footprint, it delivers full agent functionality with web search, scheduled tasks, persistent memory, and extensible skills.

About Hosting nanobot

This template deploys nanobot with a web-based configuration UI and status dashboard. Instead of editing JSON files directly, you can configure providers, channels, tools, and agent settings from your browser. The dashboard shows gateway state, uptime, provider/channel status, and live logs, with controls to start, stop, and restart the gateway. The admin panel is protected with basic authentication. A persistent volume at /data stores configuration and workspace data across container restarts.

Common Use Cases

Run a personal AI assistant accessible via Telegram, WhatsApp, or Feishu that can search the web, manage schedules, and remember context across conversations
Deploy a lightweight research-ready agent framework that's easy to understand, modify, and extend with custom skills
Set up scheduled AI tasks using cron-style automation for daily briefings, reminders, or periodic data analysis

Dependencies for nanobot Hosting

None — nanobot stores configuration and state in local files with no external database required

Deployment Dependencies

Implementation Details

Environment variables:

# Web server port
PORT=8080

# Basic auth credentials for admin panel
ADMIN_USERNAME=admin
ADMIN_PASSWORD=your_secure_password

Mount a persistent volume at /data to retain configuration and workspace data.

After deployment, open your app URL, log in with your admin credentials, and configure at least one LLM provider API key through the web UI. Supported providers include Anthropic, OpenAI, OpenRouter, DeepSeek, Groq, Gemini, Zhipu, and vLLM. Supported channels include Telegram, WhatsApp, and Feishu.

The web server exposes port 8080 with a health check endpoint at /health.

Why Deploy nanobot 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 nanobot 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.