Quick start

Get a voice agent live in under 10 minutes. Sign up, install the SDK, point it at a CRM, click Go Live. The free tier is 100 minutes - enough for a real evaluation.

1. Install the SDK

Use your favorite package manager. The JS SDK is published as @smv-ai/voice; the Python SDK is smv-voice on PyPI.

# JavaScript / TypeScript
pnpm add @smv-ai/voice

# Python
pip install smv-voice

2. Create an agent

Agents are defined declaratively. Describe the conversation goal - not every possible turn - and the runtime handles dialog management.

import { SMVClient } from "@smv-ai/voice";

const client = new SMVClient({ apiKey: process.env.SMV_API_KEY });

const agent = await client.agents.create({
  name: "Solar quote follow-up",
  voice: "marcus.warm",
  language: "en-US",
  opening: "Hi, this is {{agent.name}} from {{company.name}}.",
  flow: [
    { id: "qualify", ask: "Are you the homeowner?" },
    { id: "schedule", tool: "book_appointment" }
  ],
});

3. Make your first call

Once the agent exists, you can place a call directly through the REST API or via the SDK. Both return a streaming Call object you can subscribe to for transcripts and events.

curl -X POST https://api.smartmoveslimited.com/v1/calls \
  -H "Authorization: Bearer $SMV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"agt_123","to":"+13055550142"}'

Next steps

You're live. Now extend your agent with a knowledge base, wire up your CRM, or launch a campaign across a lead list.