Deploy pixan-agent
Claude Code-based 24/7 personal agent on Telegram in one container.
agent-kernel
Just deployed
/data
Deploy and Host Pixan agent on Railway
Pixan agent is a Claude Code-based 24/7 personal agent on Telegram, in one container, using only official components: the Claude Code harness, the official Telegram channel plugin and a managed policy file. It has memory, scheduled jobs, groups and fellow agents, with less than 300 lines of Bash. Open source, Apache-2.0.
About Hosting Pixan agent
Pixan agent runs as one service with a volume at /data, where it keeps its memory, settings, jobs and installed tools across restarts and redeploys. Railway builds the image from the repository's Dockerfile, which installs Claude Code with Anthropic's official installer during your own build. You paste three values (a new Telegram bot token, your Telegram id and a Claude credential), deploy, and message your bot; the first build takes several minutes. The service restarts on its own if the agent stops, and a watchdog tells you on Telegram if the channel dies or a message goes unanswered.
Common Use Cases
- A personal assistant on Telegram that remembers: every night it consolidates the day into its memory.
- Scheduled jobs set by chat (reminders, daily summaries), delivered to you or to a group.
- A helper in your Telegram groups: members ask for ordinary work; you and the super-users you name run it.
- Reading and making documents: PDF, Word, Excel and PowerPoint.
Dependencies for Pixan agent Hosting
- A new Telegram bot: talk to @BotFather,
/newbot, and copy its token. Use a bot that nothing else polls. - Your numeric Telegram id: ask @userinfobot.
- A Claude credential: run
claude setup-tokenon your computer for a personal agent on your Claude subscription. For an agent that serves groups or clients, use an Anthropic API key (ANTHROPIC_API_KEY) instead.
Deployment Dependencies
- Source, docs and issues: https://github.com/pixan-ai/agent-kernel
- Step-by-step guide: https://github.com/pixan-ai/agent-kernel/blob/main/docs/GETTING-STARTED.md
- What it protects and what it does not: https://github.com/pixan-ai/agent-kernel/blob/main/docs/THREAT-MODEL.md
Why Deploy Pixan 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 Pixan 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.
Updates arrive as tested releases from the repository, and going back is one click with Railway's Rollback.
Template Content
agent-kernel
pixan-ai/agent-kernelOWNER_TELEGRAM_ID
Your numeric Telegram id (ask @userinfobot). Only you can talk to the agent at first.
TELEGRAM_BOT_TOKEN
Your bot's token from @BotFather. Use a new bot that nothing else polls.

