{"id":50694230,"url":"https://github.com/cogniolab/nio-voice-agent-sdk","last_synced_at":"2026-06-09T05:07:14.867Z","repository":{"id":319118732,"uuid":"1077350857","full_name":"cogniolab/nio-voice-agent-sdk","owner":"cogniolab","description":"Open-source voice agent platform - Self-hosted alternative to enterprise voice AI. AGPL-3.0 licensed.","archived":false,"fork":false,"pushed_at":"2025-10-16T18:39:04.000Z","size":25,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-17T17:54:25.627Z","etag":null,"topics":["agpl","ai-agent","anthropic","claude","deepgram","llm","openai","sdk","self-hosted","speech-to-text","text-to-speech","typescript","voice-agent","voice-ai"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cogniolab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-16T06:16:51.000Z","updated_at":"2025-10-16T20:46:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"e29c4170-d114-4146-a103-548a283c989d","html_url":"https://github.com/cogniolab/nio-voice-agent-sdk","commit_stats":null,"previous_names":["cogniolab/nio-voice-agent-sdk"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/cogniolab/nio-voice-agent-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cogniolab%2Fnio-voice-agent-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cogniolab%2Fnio-voice-agent-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cogniolab%2Fnio-voice-agent-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cogniolab%2Fnio-voice-agent-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cogniolab","download_url":"https://codeload.github.com/cogniolab/nio-voice-agent-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cogniolab%2Fnio-voice-agent-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34092389,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agpl","ai-agent","anthropic","claude","deepgram","llm","openai","sdk","self-hosted","speech-to-text","text-to-speech","typescript","voice-agent","voice-ai"],"created_at":"2026-06-09T05:07:14.272Z","updated_at":"2026-06-09T05:07:14.859Z","avatar_url":"https://github.com/cogniolab.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nio Voice Agent SDK\n\n**Open-source voice agent platform - Self-hosted alternative to enterprise voice AI solutions**\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)\n[![Node.js](https://img.shields.io/badge/Node.js-18+-green)](https://nodejs.org/)\n\n## 🎯 Why Nio Voice Agent SDK?\n\nBuilding production voice agents shouldn't require months of integration work and enterprise budgets. Nio Voice Agent SDK provides:\n\n- **🚀 Deploy in minutes, not months** - Pre-built integrations with leading LLM and voice providers\n- **💰 Self-hosted or managed** - Run on your infrastructure or use Nio Voice Cloud\n- **🔌 MCP-native** - Built-in support for Model Context Protocol\n- **🧪 Testing-first** - Human-in-the-loop testing framework included\n- **📦 Production-ready** - Session management, streaming, error handling built-in\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                 Nio Voice Agent SDK                          │\n├─────────────────────────────────────────────────────────────┤\n│                                                               │\n│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │\n│  │  Voice SDK   │  │     MCP      │  │   Testing    │      │\n│  │              │  │  Framework   │  │  Framework   │      │\n│  │ • Providers  │  │ • Adapters   │  │ • HITL       │      │\n│  │ • Streaming  │  │ • Connectors │  │ • Scenarios  │      │\n│  │ • Session    │  │ • Testing    │  │ • Assertions │      │\n│  └──────────────┘  └──────────────┘  └──────────────┘      │\n│                                                               │\n│  ┌─────────────────────────────────────────────────┐        │\n│  │         Embeddable Voice Widget                  │        │\n│  │         React + Vanilla JS                       │        │\n│  └─────────────────────────────────────────────────┘        │\n│                                                               │\n└─────────────────────────────────────────────────────────────┘\n         ↓                  ↓                    ↓\n┌───────────────┐  ┌───────────────┐  ┌──────────────────┐\n│   Deepgram    │  │  Claude AI    │  │ Your Business    │\n│   OpenAI STT  │  │  OpenAI GPT   │  │ Logic (MCP)      │\n│   ElevenLabs  │  │  Groq         │  │                  │\n└───────────────┘  └───────────────┘  └──────────────────┘\n```\n\n## 📦 Packages\n\n### Core Packages\n\n- **[@nio-voice/sdk](./packages/voice-sdk)** - Core voice agent SDK with provider integrations\n- **[@nio-voice/mcp-framework](./packages/mcp-framework)** - Model Context Protocol framework for integrations\n- **[@nio-voice/testing](./packages/testing-framework)** - Human-in-the-loop testing framework\n- **[@nio-voice/widget](./packages/widget)** - Embeddable voice widget for websites\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\nnpm install @nio-voice/sdk @nio-voice/mcp-framework\n```\n\n### Basic Voice Agent\n\n```typescript\nimport { VoiceAgent, DeepgramProvider, ClaudeProvider } from '@nio-voice/sdk';\n\nconst agent = new VoiceAgent({\n  speech: new DeepgramProvider({\n    apiKey: process.env.DEEPGRAM_API_KEY\n  }),\n  llm: new ClaudeProvider({\n    apiKey: process.env.ANTHROPIC_API_KEY,\n    model: 'claude-3-5-sonnet-20241022'\n  }),\n  systemPrompt: 'You are a helpful customer service agent.'\n});\n\n// Start voice session\nawait agent.startSession({\n  onTranscript: (text) =\u003e console.log('User said:', text),\n  onResponse: (text) =\u003e console.log('Agent said:', text),\n  onEnd: () =\u003e console.log('Session ended')\n});\n```\n\n### With MCP Integration\n\n```typescript\nimport { VoiceAgent } from '@nio-voice/sdk';\nimport { MCPAdapter } from '@nio-voice/mcp-framework';\n\nconst agent = new VoiceAgent({\n  // ... voice config\n  mcp: new MCPAdapter({\n    serverUrl: 'http://localhost:3000/mcp',\n    tools: ['book_appointment', 'check_availability']\n  })\n});\n\n// Agent can now call your business functions via MCP\n```\n\n### Add to Your Website\n\n```html\n\u003cscript src=\"https://unpkg.com/@nio-voice/widget@latest\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n  NioVoice.init({\n    apiKey: 'your-api-key',\n    agentId: 'your-agent-id',\n    position: 'bottom-right'\n  });\n\u003c/script\u003e\n```\n\n## 🎨 Examples\n\nCheck out the [examples](./examples) directory for complete working examples:\n\n- **[Basic Agent](./examples/basic-agent)** - Simple customer service agent\n- **[Appointment Booking](./examples/appointment-booking)** - Full booking workflow with MCP\n- **[Customer Support](./examples/customer-support)** - Multi-turn support conversations\n\n## 📚 Documentation\n\n- [Getting Started Guide](./docs/guides/getting-started.md)\n- [Voice SDK API Reference](./docs/api/voice-sdk.md)\n- [MCP Framework Guide](./docs/api/mcp-framework.md)\n- [Testing Framework Guide](./docs/api/testing-framework.md)\n- [Widget Integration Guide](./docs/guides/widget-integration.md)\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n## 📜 License\n\nThis project is licensed under **AGPL-3.0** - see the [LICENSE](./LICENSE) file for details.\n\n### What does AGPL-3.0 mean?\n\n- ✅ **Free to use** for personal and commercial projects\n- ✅ **Modify and distribute** your changes\n- ⚠️ **Network use = distribution** - If you offer this as a service over a network, you must share your source code\n- 💼 **Commercial license available** - Contact dev@cogniolab.com for closed-source licensing\n\n### Why AGPL?\n\nWe chose AGPL-3.0 to ensure that improvements to voice AI technology remain open and accessible to everyone. If you build a hosted service using this code, your users deserve the same freedoms.\n\n**Need a proprietary license?** Contact dev@cogniolab.com\n\n## 🌟 Nio Voice Cloud\n\nDon't want to self-host? Use [Nio Voice Cloud](https://nioai.us/) for:\n\n- 🎯 **Auto-discovery** - Paste your website URL, get a voice agent instantly\n- 🏭 **Industry templates** - Pre-built for healthcare, HVAC, retail, etc.\n- 📊 **Analytics dashboard** - Conversation insights and call analytics\n- 🔧 **Managed infrastructure** - No servers to manage\n- 💬 **Priority support** - Direct access to the Nio team\n\n**Pricing**: $299-$2999/month (vs $100K+ for enterprise alternatives)\n\n## 🆚 Comparison\n\n| Feature | Nio Voice SDK (Open Source) | Retell AI / Vapi | Enterprise (Poly.ai) |\n|---------|---------------------------|-----------------|---------------------|\n| **Setup Time** | Minutes | Hours | Months |\n| **Cost** | Free (self-hosted) | Usage-based ($$) | $100K+ |\n| **Flexibility** | Full control | API limits | Consultative |\n| **Lock-in** | None | Vendor lock-in | Contract lock-in |\n| **Hosting** | Your infrastructure | Their cloud | Their cloud |\n| **Source Code** | Available (AGPL) | Closed | Closed |\n\n## 🎯 Roadmap\n\n- [x] Core voice SDK with Deepgram/OpenAI\n- [x] Claude and GPT integration\n- [x] MCP framework\n- [x] Testing framework\n- [x] Embeddable widget\n- [ ] Phone system integration (Twilio/Bandwidth)\n- [ ] Advanced voice customization\n- [ ] Multi-language support\n- [ ] Real-time translation\n- [ ] Voice analytics SDK\n\n## 💬 Community\n\nJoin our community to ask questions, share ideas, and connect with other developers building voice-enabled AI agents!\n\n- **[GitHub Discussions](https://github.com/cogniolab/nio-voice-agent-sdk/discussions)** - Ask questions, share your work, and discuss best practices\n- **Email**: dev@cogniolab.com\n- **Enterprise Support**: Available with commercial license\n\nWe're building a supportive community where developers help each other create amazing voice AI experiences. Whether you're just getting started or building production systems, your questions and contributions are welcome!\n\n---\n\n**Built with ❤️ by [Cognio Lab](https://cogniolab.com)**\n\n*Making voice AI accessible to everyone*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcogniolab%2Fnio-voice-agent-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcogniolab%2Fnio-voice-agent-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcogniolab%2Fnio-voice-agent-sdk/lists"}