Deploy

This chapter covers deployment options from development to production.

What you’ll learn

1. Local Development - Running agents during development
2. Production - Deploying to production servers
3. Serverless - AWS Lambda, Google Cloud Functions, Azure Functions
4. Docker & Kubernetes - Container-based deployment
5. CGI Mode - Traditional web server deployment

Deployment options overview

Environment detection

The SDK automatically detects your deployment environment:

Chapter contents

Quick start

1
#!/usr/bin/env python3
2
from signalwire import AgentBase
3
4
class MyAgent(AgentBase):
5
    def __init__(self):
6
        super().__init__(name="my-agent")
7
        self.add_language("English", "en-US", "rime.spore")
8
        self.prompt_add_section("Role", "You are a helpful assistant.")
9
10
if __name__ == "__main__":
11
    agent = MyAgent()
12
    agent.run()

The run() method automatically:

• Detects serverless environments (Lambda, Cloud Functions, Azure) (Python only)
• Starts a development server on localhost for local development
• Handles CGI mode when deployed to traditional web servers (Python only)

The SignalWire TypeScript SDK (@signalwire/sdk) is ESM-only. Your package.json must set "type": "module", or your entry file must be named .mjs. Otherwise Node will try to load it as CommonJS and imports will fail.

Starting the development server

The simplest way to run your agent locally:

All languages default to http://localhost:3000.