Getting Started Today 🔗

Ready to build the future of communication? Here's how to get started with SignalWire and the AI Agents SDK right now.

Step 1: Create Your Free SignalWire Space 🔗

Head to signalwire.com and click "Start Building". You'll have a free space set up in under a minute. No credit card required. Our developer advocates will reach out via email to offer personalized assistance.

Step 2: Install the SDK 🔗

# Basic installation
pip install signalwire-agents

# Full-featured installation with search capabilities
pip install signalwire-agents[search-full]

Step 3: Create Your First Agent 🔗

Create a file called my_agent.py:

from signalwire_agents import AgentBase

class MyFirstAgent(AgentBase):
    def __init__(self):
        super().__init__(name="My First Agent")

        # Define the agent's personality
        self.prompt_add_section(
            "Role",
            "You are a helpful assistant. Be friendly and professional."
        )

        # Add some capabilities
        self.add_skill("datetime")
        self.add_skill("math")
        self.add_skill("web_search")

if __name__ == "__main__":
    agent = MyFirstAgent()
    agent.run()

Step 4: Test Locally 🔗

# Run your agent
python my_agent.py

# In another terminal, test it
swaig-test my_agent.py --list-tools
swaig-test my_agent.py --exec get_current_time

Step 5: Connect to SignalWire 🔗

In your SignalWire dashboard:

1. Navigate to "Phone Numbers"
2. Assign a number to your agent's URL
3. Make a test call
4. Experience sub-second AI responses

Explore Ready-Made Examples 🔗

Visit our GitHub repository for production-ready examples:

git clone https://github.com/signalwire/signalwire-agents
cd signalwire-agents/examples

# Try the customer service agent
python customer_service_agent.py

# Run the multi-agent system
python multi_agent_server.py

# Test the healthcare assistant
python healthcare_agent.py

Join the Community 🔗

Discord: Join our active Discord server for real-time help and discussions with other developers building on SignalWire.

GitHub: Star the repository, submit issues, and contribute improvements.

ClueCon: Register for ClueCon.com - our annual developer conference where you'll meet the team and community in person.

Resources for Success 🔗

Documentation Hub: Comprehensive guides, API references, and tutorials at docs.signalwire.com

Video Templates: Try working demos directly from the SignalWire dashboard

Developer Advocates: Our team is here to help. They'll reach out when you sign up, or contact them directly through Discord.

Office Hours: Weekly sessions where you can get direct help from our engineering team

Start with Templates 🔗

Don't start from scratch. Use our prefab agents:

from signalwire_agents.prefabs import InfoGathererAgent

# Instant structured data collection
agent = InfoGathererAgent(
    name="Survey Bot",
    fields=[
        {"name": "name", "description": "Your full name", "required": True},
        {"name": "email", "description": "Email address", "required": True},
        {"name": "feedback", "description": "Your feedback", "required": True}
    ]
)
agent.run()

Build Something Amazing This Weekend 🔗

Here's a challenge: Build a working AI agent this weekend. Some ideas:

• Pizza Order Bot: Take orders, confirm details, send to kitchen
• Appointment Scheduler: Book appointments with calendar integration
• Technical Support Agent: Answer FAQs with document search
• Survey Collector: Gather customer feedback efficiently
• Emergency Notification System: Alert systems with voice confirmation

Share what you build in our Discord. The best implementations get featured in our showcase.