agents  by livekit

Voice AI agent framework for building realtime applications

created 1 year ago
6,916 stars

Top 7.5% on sourcepulse

GitHubView on GitHub
Project Summary

This framework enables the creation of real-time voice AI agents that can see, hear, and speak, targeting developers building server-side agentic applications. It offers flexible integrations with various AI models and seamless WebRTC and telephony capabilities, reducing interruptions with semantic turn detection.

How It Works

The framework uses an Agent-AgentSession model, where Agents define instructions and tools, and AgentSessions manage interactions, orchestrating Speech-to-Text (STT), Large Language Models (LLM), Text-to-Speech (TTS), and Voice Activity Detection (VAD). It leverages LiveKit's WebRTC infrastructure for real-time communication and supports custom plugins for different model providers, allowing for modular and adaptable agent development.

Quick Start & Requirements

  • Install core library and plugins: pip install "livekit-agents[openai,silero,deepgram,cartesia,turn-detector]~=1.0"
  • Environment variables required: LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET, DEEPGRAM_API_KEY, OPENAI_API_KEY.
  • Documentation: https://docs.livekit.io/agents/
  • Playground: https://agents.livekit.io/

Highlighted Details

  • Supports multi-agent handoffs and complex conversational flows.
  • Integrates with LiveKit's telephony stack for outbound/inbound calls.
  • Offers semantic turn detection using transformer models.
  • Provides various example applications, including vision-enabled agents.

Maintenance & Community

  • Actively developed with a focus on rapid evolution in AI.
  • Contributions are welcomed via issues, PRs, and the LiveKit Slack community.

Licensing & Compatibility

  • Primarily Apache 2.0 licensed, allowing for commercial use and closed-source linking.

Limitations & Caveats

  • Requires specific API keys for integrated services (OpenAI, Deepgram).
  • The framework is under active development, implying potential for breaking changes.
Health Check
Last commit

3 days ago

Responsiveness

1 day

Pull Requests (30d)
158
Issues (30d)
123
Star History
1,191 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.