Hosted agents quickstart

Put a voice agent on the phone and on your website without running any servers. KugelAudio hosts the agent, answers its calls and keeps it live. You start by talking to Juno, a ready-made agent, and then deploy an agent of your own.

1. 1
   Talk to Juno

   Open Agents in the dashboard, choose Create agent, then pick Juno under Add your agent. Juno is a personal assistant that plans your day and remembers notes.

   The dashboard reads Juno's source, builds it and makes it live, then opens the Playground. Start a call and try "Put buy milk on my list."

   Juno runs on keys KugelAudio provides. Its calls count against your plan's agent minutes like any agent's, and the Playground shows how many are left when your plan has a limit.

2. 2
   Create your own agent

   You need Node.js 22.12 or later. Create a project from the agent template. It starts as a copy of Juno that you change into your own agent:

   Bash

   npx --yes --allow-remote=all https://cdn.kugelaudio.com/curb/create-curb-app-latest.tgz my-agent

   --allow-remote=all lets npm 12 run a package from a URL. The project's AGENTS.md explains how the agent is built: its prompt, skills and tools.

3. 3
   Add your keys

   The agent needs two keys in the project's .env file. The setup asks for them and writes .env; to add or change one later, edit .env.

   • ANTHROPIC_API_KEY for the language model, from your Anthropic account.
   • KUGELAUDIO_API_KEY for speech, from the API keys page.

   The agent hears callers with Kugel Ear 1 and answers with KugelAudio voices, so it needs no other speech key.

4. 4
   Try it on your machine
   Bash

   cd my-agent && npm run dev

   Your browser opens the agent's preview. Type, or press Start call and talk. The preview shows your agent's context: its instructions, the skills it can open and the tools it can call. You do not change the agent in the preview. Ask your coding agent to change it, or edit the files yourself, and the preview shows the result.

   Check the project for mistakes, then talk to the agent in the terminal, the way a coding agent does:

   Bash

   npx curb check
   npx curb say "Hello"
   npx curb test

   curb say runs one caller turn and the next one continues the conversation. curb test replays the conversations kept in src/**/*.scenario.ts, with scripted caller lines or a simulated caller, and fails when one goes wrong.

5. 5
   Deploy
   Bash

   npx curb login
   npx curb secrets push
   npx curb deploy

   curb login opens the KugelAudio sign-in page in your browser; confirm, and the terminal is signed in. curb secrets push sends the keys in .env to the agent and prints their names, never the values. It skips KUGELAUDIO_API_KEY, which KugelAudio provides to every hosted agent. curb deploy uploads the project, builds it and makes it the agent's live version. It ends with a link to the agent's Playground, where you can call it.

Calls are billed per minute; see pricing.

Let your coding agent do it

Build your own agent on Juno's Playground has a prompt for a coding agent such as Claude Code, Cursor or Codex. Start the coding agent in an empty folder on your machine and paste the prompt: it asks what your agent should do, then runs the steps above for you. It asks you for your keys and never prints them. Connect it to KugelAudio first, and it also deploys and reads build and call errors through the MCP server.

Next steps