---
title: "Deploy JupyterLab (w/ Claude agent)"
description: "JupyterLab with a Claude agent that edits and runs your notebooks."
category: "AI/ML"
url: https://railway.com/deploy/jupyterlab-w-claude-agent
---

# Deploy JupyterLab (w/ Claude agent)

JupyterLab with a Claude agent that edits and runs your notebooks.

**[Deploy JupyterLab (w/ Claude agent) on Railway](https://railway.com/template/jupyterlab-w-claude-agent)**

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

- **Creator:** AvgSoft
- **Category:** AI/ML

## Template content

### JupyterLab https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@e27ec7cd95fc0354f185fc09384927a0b7a9abc0/service-icons/jupyter.svg

- **Image:** quay.io/jupyter/scipy-notebook:2026-10-28
- **Start command:** `/bin/sh -c 'echo IyEvYmluL3NoCiMgSnVweXRlckxhYiAody8gQ2xhdWRlIGFnZW50KTogdGhlIEp1cHl0ZXJMYWIgc2VydmljZSdzIHN0YXJ0IHNjcmlwdC4KIyBUaGUgdGVtcGxhdGUncyBzdGFydCBjb21tYW5kIHdyaXRlcyB0aGlzIGZpbGUgZnJvbSBiYXNlNjQgYW5kIHJ1bnMgaXQgKG1ha2Utc3RhcnQtY29tbWFuZC5tanMpLgojCiMgQXMgcm9vdDogcHJlcGFyZSB0aGUgdm9sdW1lICh0aGUgaG9tZSBmb2xkZXIpIGFuZCB0aGUgcGFzc3dvcmQsIHRoZW4gaGFuZCBvdmVyIHRvIHRoZSBpbWFnZSdzIG93biBzdGFydC5zaCwKIyB3aGljaCBkcm9wcyB0byBqb3Z5YW4gYW5kIHJ1bnMgdGhpcyBzY3JpcHQgYWdhaW4uCiMgQXMgam92eWFuOiBpbnN0YWxsIHRoZSBDbGF1ZGUgYWdlbnQgb250byB0aGUgdm9sdW1lIG9uY2UsIHRoZW4gc3RhcnQgSnVweXRlckxhYi4KSD0vaG9tZS9qb3Z5YW4KTk9ERT12MjQuMjIuMgpOT0RFX1NIQTI1Nj00OGNjMGUyMWUwNDg3OTBlNTRjMGNmNTc0OWMyNzI1MDA1MzEzZDY1MjY1MWM0MGI3YTIxZmViOTY5N2FhZjc1CkFDUD0wLjk5LjAKSlVQWVRFUl9BST0zLjIuMApleHBvcnQgUEFUSD0kSC8ubG9jYWwvYmluOiRILy5sb2NhbC9zaGFyZS9ub2RlL2JpbjokUEFUSAojIFF1aWV0IGxvZ3M6IG5vIG5wbSB1cGRhdGUgbm90aWNlLCBubyB1cGRhdGUgY2hlY2sgZnJvbSB0aGUgRmFzdE1DUCBzZXJ2ZXIgaW5zaWRlIEp1cHl0ZXIgQUkuCmV4cG9ydCBOUE1fQ09ORklHX1VQREFURV9OT1RJRklFUj1mYWxzZSBGQVNUTUNQX0NIRUNLX0ZPUl9VUERBVEVTPW9mZgoKaWYgWyAiJChpZCAtdSkiID0gMCBdOyB0aGVuCiAgcm0gLXJmICRIL2xvc3QrZm91bmQKICBmb3IgZiBpbiAuYmFzaHJjIC5wcm9maWxlOyBkbyBbIC1lICRILyRmIF0gfHwgaW5zdGFsbCAtbyAxMDAwIC1nIDEwMCAtbSA2NDQgL2V0Yy9za2VsLyRmICRILyRmOyBkb25lCiAgIyBQeXRob24gb25seSBwdXRzIH4vLmxvY2FsJ3Mgc2l0ZS1wYWNrYWdlcyBvbiBzeXMucGF0aCBpZiBpdCBleGlzdHMgd2hlbiB0aGUga2VybmVsIHN0YXJ0cy4KICBkPSQoSE9NRT0kSCBweXRob24gLW0gc2l0ZSAtLXVzZXItc2l0ZSkKICBta2RpciAtcCAkZCAmJiBjaG93biAxMDAwOjEwMCAkSC8ubG9jYWwgJEgvLmxvY2FsL2xpYiAke2QlLyp9ICRkCiAgcHl0aG9uIC1jICJpbXBvcnQganNvbixvcyxzeXM7ZnJvbSBqdXB5dGVyX3NlcnZlci5hdXRoIGltcG9ydCBwYXNzd2Q7anNvbi5kdW1wKGRpY3QoUGFzc3dvcmRJZGVudGl0eVByb3ZpZGVyPWRpY3QoaGFzaGVkX3Bhc3N3b3JkPXBhc3N3ZChvcy5lbnZpcm9uLmdldChzeXMuYXJndlsxXSkgb3Igc3lzLmV4aXQoc3lzLmFyZ3ZbMl0pKSkpLHN5cy5zdGRvdXQpIiBcCiAgICBKVVBZVEVSX1BBU1NXT1JEICJKVVBZVEVSX1BBU1NXT1JEIGlzIGVtcHR5OiBzZXQgaXQgaW4gdGhlIEp1cHl0ZXJMYWIgc2VydmljZSB2YXJpYWJsZXMuIiA+IC9ldGMvanVweXRlci9qdXB5dGVyX3NlcnZlcl9jb25maWcuanNvbiB8fCBleGl0IDEKICBleGVjIHRpbmkgLWcgLS0gc3RhcnQuc2ggc2ggIiQwIgpmaQoKd2FudD0ibm9kZSAkTk9ERSwgY2xhdWRlLWFnZW50LWFjcCAkQUNQLCBqdXB5dGVyLWFpICRKVVBZVEVSX0FJIgpzdGFtcD0kSC8ubG9jYWwvc2hhcmUvY2xhdWRlLWFnZW50L2luc3RhbGxlZApmcmVlX21iPSQoZGYgLVBtICRIIHwgYXdrICdOUj09MiB7cHJpbnQgJDR9JykKaWYgWyAiJChjYXQgJHN0YW1wIDI+L2Rldi9udWxsKSIgPSAiJHdhbnQiIF07IHRoZW4KICA6CmVsaWYgWyAiJHtmcmVlX21iOi0wfSIgLWx0IDgwMCBdOyB0aGVuCiAgIyBGcmVlIGFuZCBUcmlhbCB2b2x1bWVzIGFyZSAwLjUgR0I6IGEgaGFsZi1maW5pc2hlZCBpbnN0YWxsIHdvdWxkIGxlYXZlIG5vIHJvb20gZm9yIG5vdGVib29rcy4KICBlY2hvICJbY2xhdWRlXSBvbmx5ICR7ZnJlZV9tYn0gTUIgZnJlZSBvbiB0aGUgdm9sdW1lIGFuZCB0aGUgYWdlbnQgbmVlZHMgYWJvdXQgNjAwIE1COyBKdXB5dGVyTGFiIHN0YXJ0cyB3aXRob3V0IHRoZSBDbGF1ZGUgYWdlbnQiCmVsc2UKICBlY2hvICJbY2xhdWRlXSBpbnN0YWxsaW5nICR3YW50IG9udG8gdGhlIHZvbHVtZSAoZmlyc3Qgc3RhcnQgb25seSwgYWJvdXQgYSBtaW51dGUpIgogIGlmICgKICAgIHNldCAtZQogICAgbWtkaXIgLXAgJEgvLmxvY2FsL3NoYXJlL2NsYXVkZS1hZ2VudAogICAgaWYgWyAiJCgkSC8ubG9jYWwvc2hhcmUvbm9kZS9iaW4vbm9kZSAtLXZlcnNpb24gMj4vZGV2L251bGwpIiAhPSAiJE5PREUiIF07IHRoZW4KICAgICAgY2QgL3RtcAogICAgICB3Z2V0IC1xIC0tbm8taHN0cyBodHRwczovL25vZGVqcy5vcmcvZGlzdC8kTk9ERS9ub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHoKICAgICAgZWNobyAiJE5PREVfU0hBMjU2ICBub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHoiIHwgc2hhMjU2c3VtIC1jIC0tcXVpZXQgLQogICAgICBybSAtcmYgJEgvLmxvY2FsL3NoYXJlL25vZGUgJiYgbWtkaXIgLXAgJEgvLmxvY2FsL3NoYXJlL25vZGUKICAgICAgdGFyIC14SmYgbm9kZS0kTk9ERS1saW51eC14NjQudGFyLnh6IC1DICRILy5sb2NhbC9zaGFyZS9ub2RlIC0tc3RyaXAtY29tcG9uZW50cyAxCiAgICAgIHJtIC1yZiBub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHogJEgvLmxvY2FsL3NoYXJlL25vZGUvaW5jbHVkZSAgIyBDIGhlYWRlcnMsIDY3IE1CLCBvbmx5IGZvciBidWlsZGluZyBuYXRpdmUgYWRkb25zCiAgICBmaQogICAgIyBucG0ncyBkb3dubG9hZCBjYWNoZSBnb2VzIHRvIC90bXAsIG5vdCB0aGUgdm9sdW1lICgxNzAgTUIgZm9yIHRoZSBhZ2VudCkKICAgIG5wbSBpbnN0YWxsIC0tZ2xvYmFsIC0tcHJlZml4ICRILy5sb2NhbCAtLWNhY2hlIC90bXAvbnBtLWNhY2hlIC0tbm8tZnVuZCAtLW5vLWF1ZGl0IC0tbG9nbGV2ZWwgZXJyb3IgQGFnZW50Y2xpZW50cHJvdG9jb2wvY2xhdWRlLWFnZW50LWFjcEAkQUNQCiAgICBybSAtcmYgL3RtcC9ucG0tY2FjaGUKICAgIHBpcCBpbnN0YWxsIC0tcXVpZXQgLS1uby13YXJuLXNjcmlwdC1sb2NhdGlvbiBqdXB5dGVyLWFpPT0kSlVQWVRFUl9BSQogICAgZWNobyAiJHdhbnQiID4gJHN0YW1wCiAgKTsgdGhlbgogICAgZWNobyAiW2NsYXVkZV0gaW5zdGFsbGVkIgogIGVsc2UKICAgIGVjaG8gIltjbGF1ZGVdIGluc3RhbGwgZmFpbGVkOyBKdXB5dGVyTGFiIHN0YXJ0cyB3aXRob3V0IHRoZSBDbGF1ZGUgYWdlbnQgYW5kIHJldHJpZXMgb24gdGhlIG5leHQgc3RhcnQiCiAgZmkKZmkKCmV4ZWMgc3RhcnQtbm90ZWJvb2sucHkgLS1TZXJ2ZXJBcHAudHJ1c3RfeGhlYWRlcnM9VHJ1ZQo= | base64 -d > /usr/local/bin/railway-boot.sh && exec sh /usr/local/bin/railway-boot.sh'`
- **Health check:** /api
- **Public domain:** Yes

## Documentation

# Deploy and Host JupyterLab (w/ Claude agent) on Railway

JupyterLab is the notebook editor for Python and data work. This template adds Claude through Jupyter AI: it edits your notebooks, runs cells and commands, and asks before it writes or runs anything.

![JupyterLab with a Claude agent that edits and runs notebooks](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@56db5a52196bf5c32e9b4cca84b5d81015729315/jupyterlab-claude/banner.png)

## About Hosting JupyterLab (w/ Claude agent)

Choose a password and paste your Anthropic API key on the deploy form. The first start installs the agent onto the volume (about 30 seconds). Sign in, click the chat icon on the left, start a new chat and pick Claude. Everything survives redeploys.

## Common Use Cases

- Exploring data with Claude
- Writing and fixing notebooks
- Explaining results

## Dependencies for JupyterLab (w/ Claude agent) Hosting

- JupyterLab (Jupyter's scipy-notebook image)
- Jupyter AI with the Claude agent
- An Anthropic API key

### Deployment Dependencies

- [Jupyter AI documentation](https://jupyter-ai.readthedocs.io/en/stable/)
- [Anthropic API keys](https://console.anthropic.com/settings/keys)

### Implementation Details

![Architecture: JupyterLab and the Claude agent in one service; notebooks, packages and the agent on the volume](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@fb7af982c47783bb7fce56f1bb4e16b86c0fb8fc/jupyterlab-claude/architecture.png)

The agent needs about 0.6 GB of volume, more than Free and Trial allow. Usage is billed to your Anthropic account. Back up the volume.

## Why Deploy JupyterLab (w/ Claude 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 JupyterLab (w/ Claude 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.


**Updated 2026-10-29:** first release, JupyterLab 4.6.4, Jupyter AI 3.2.0, Claude ACP adapter 0.99.0.


## 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 v0.1 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/jupyterlab-w-claude-agent