Deploy and Host Kortix SUNA AI on Railway

Suna is an open-source AI assistant designed to simplify real-world tasks through natural conversation. It acts as a digital companion for research, data analysis, and daily challenges by combining powerful capabilities with an intuitive interface that understands user needs and delivers results.

Feel free to discuss any deployment issues.

About Hosting Kortix SUNA AI

• Daytona - Secure agent execution environment
• Supabase - Database and authentication
• Playwright - Browser automation
• OpenAI - LLM provider
• Anthropic - LLM provider
• Tavily - Search capabilities
• Firecrawl - Web scraping capabilities
• QStash - Background job processing and workflows
• RapidAPI - API services
• Smithery - Custom agent development

Common Use Cases

1. Competitor Analysis (Watch) - "Analyze the market for my next company in the healthcare industry, located in the UK. Give me the major players, their market size, strengths, and weaknesses, and add their website URLs. Once done, generate a PDF report."

2. VC List (Watch) - "Give me the list of the most important VC Funds in the United States based on Assets Under Management. Give me website URLs, and if possible an email to reach them out."

3. Looking for Candidates (Watch) - "Go on LinkedIn, and find me 10 profiles available - they are not working right now - for a junior software engineer position, who are located in Munich, Germany. They should have at least one bachelor's degree in Computer Science or anything related to it, and 1-year of experience in any field/role."

4. Planning Company Trip (Watch) - "Generate me a route plan for my company. We should go to California. We'll be in 8 people. Compose the trip from the departure (Paris, France) to the activities we can do considering that the trip will be 7 days long - departure on the 21st of Apr 2025. Check the weather forecast and temperature for the upcoming days, and based on that, you can plan our activities (outdoor vs indoor)."

5. Working on Excel (Watch) - "My company asked me to set up an Excel spreadsheet with all the information about Italian lottery games (Lotto, 10eLotto, and Million Day). Based on that, generate and send me a spreadsheet with all the basic information (public ones)."

Dependencies for Kortix SUNA AI Hosting

• LLM Provider (at least one of the following):

  • Anthropic - Recommended for best performance
  • OpenAI
  • OpenRouter

• Search and Web Scraping:

  • Tavily - For enhanced search capabilities
  • Firecrawl - For web scraping capabilities

• Agent Execution:

  • Daytona - For secure agent execution

• Background Job Processing:

  • QStash - For workflows, automated tasks, and webhook handling

Deployment Dependencies

1.Supabase Configuration

1. Clone repo and Log in to the Supabase CLI
2. Link your local project to your Supabase project
3. Push database migrations
4. Manually expose the 'basejump' schema in Supabase:
   • Go to your Supabase project
   • Navigate to Project Settings → API
   • Add 'basejump' to the Exposed Schema section

2. Daytona Configuration

1. Create a Daytona account
2. Generate an API key
3. Create a Snapshot:
   • Name: kortix/suna:0.1.3
   • Image name: kortix/suna:0.1.3
   • Entrypoint: /usr/bin/supervisord -n -c /etc/supervisor/conf.d/supervisord.conf

3. QStash Configuration

QStash is required for background job processing, workflows, and webhook handling:

1. Create an account at Upstash Console
2. Get your QStash token and signing keys
3. Configure a publicly accessible webhook base URL for workflow callbacks

Post-Installation Steps

After completing the deployment, you'll need to:

1. Create an account - Use Supabase authentication to create your first account
2. Verify installations - Check that all components are running correctly

Backend configuration:

# Environment Mode
ENV_MODE=production

# DATABASE
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# REDIS
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_SSL=false

# RABBITMQ
RABBITMQ_HOST=rabbitmq
RABBITMQ_PORT=5672

# LLM Providers
ANTHROPIC_API_KEY=your-anthropic-key
OPENAI_API_KEY=your-openai-key
OPENROUTER_API_KEY=your-openrouter-key
MODEL_TO_USE=anthropic/claude-sonnet-4-20250514

# WEB SEARCH
TAVILY_API_KEY=your-tavily-key

# WEB SCRAPE
FIRECRAWL_API_KEY=your-firecrawl-key
FIRECRAWL_URL=https://api.firecrawl.dev

# Sandbox container provider
DAYTONA_API_KEY=your-daytona-key
DAYTONA_SERVER_URL=https://app.daytona.io/api
DAYTONA_TARGET=us

# Background job processing (Required)
QSTASH_URL=https://qstash.upstash.io
QSTASH_TOKEN=your-qstash-token
QSTASH_CURRENT_SIGNING_KEY=your-current-signing-key
QSTASH_NEXT_SIGNING_KEY=your-next-signing-key
WEBHOOK_BASE_URL=https://yourdomain.com

# MCP Configuration
MCP_CREDENTIAL_ENCRYPTION_KEY=your-generated-encryption-key

# Optional APIs
RAPID_API_KEY=your-rapidapi-key
SMITHERY_API_KEY=your-smithery-key

NEXT_PUBLIC_URL=http://localhost:3000

Frontend Configuration

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
NEXT_PUBLIC_BACKEND_URL=http://localhost:8000/api
NEXT_PUBLIC_URL=http://localhost:3000
NEXT_PUBLIC_ENV_MODE=LOCAL

Why Deploy Kortix SUNA AI 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 Kortix SUNA AI 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.