vixio 0.1.2

Voice-Powered Agent Framework

Vixio

A streaming voice-powered agent framework based on pipeline architecture

中文文档

Features

• Pipeline Architecture: Chain multiple stations to form a complete processing flow
• Station-based Processing: Each station handles specific tasks (VAD/ASR/Agent/TTS)
• Streaming Support: Real-time audio processing with async queue chains
• Modular Design: Install only what you need with optional dependencies
• Multiple Providers: Support for both local inference and cloud services

Requirements

• Python 3.12 or higher
• uv (recommended package manager)

🚀 Quick Start

Get started with Vixio in just one command! Experience real-time voice conversation powered by Qwen Omni:

# Install and run in one step (requires DashScope API key)
uvx vixio run xiaozhi-server \
  --preset qwen-realtime \
  --dashscope-key sk-your-key-here

What you get:

• 🎙️ WebSocket server running at http://localhost:8000
• 🤖 End-to-end voice AI with Qwen Omni Realtime
• ⚡ Low latency, integrated VAD + ASR + LLM + TTS
• 📱 Ready for xiaozhi devices or custom clients

Get your API key: DashScope Console

Customize Your Bot

# Use custom prompt
uvx vixio run xiaozhi-server \
  --preset qwen-realtime \
  --dashscope-key sk-xxx \
  --prompt "你是一个专业的编程助手"

# Use pipeline mode (more control)
uvx vixio run xiaozhi-server \
  --dashscope-key sk-xxx

# Export template for full customization
uvx vixio init xiaozhi-server
cd xiaozhi-server
# Edit .env, config.yaml, prompt.txt
python run.py

---

Installation

Using uv (Recommended)

1. Install with core dependencies only:

uv pip install vixio

2. Install with specific providers:

# For Chinese local development (VAD + ASR + TTS + Agent)
uv pip install "vixio[dev-local-cn]"

# For Qwen platform integration
uv pip install "vixio[dev-qwen]"

# Or install individual components
uv pip install "vixio[xiaozhi,openai-agent,silero-vad-grpc]"

Using pip

pip install vixio

# With optional dependencies
pip install "vixio[dev-local-cn]"

Available Components

Transports

• xiaozhi - Xiaozhi protocol transport (WebSocket + HTTP)

VAD (Voice Activity Detection)

• silero-vad-grpc - Silero VAD via gRPC service
• silero-vad-local - Silero VAD local inference

ASR (Automatic Speech Recognition)

• sherpa-onnx-asr-grpc - Sherpa-ONNX ASR via gRPC service
• sherpa-onnx-asr-local - Sherpa-ONNX ASR local inference
• qwen - Qwen platform ASR

TTS (Text-to-Speech)

• kokoro-cn-tts-grpc - Kokoro TTS via gRPC service
• kokoro-cn-tts-local - Kokoro TTS local inference
• edge-tts - Microsoft Edge TTS (cloud)
• qwen - Qwen platform TTS

Agent

• openai-agent - OpenAI-compatible LLM via LiteLLM

docker

CPU version

docker compose -f inference/docker-compose-inference.yml up -d --build

for China user

docker compose -f inference/docker-compose-inference.yml -f inference/docker-compose-inference-cn.yml up -d --build

GPU version

docker compose -f inference/docker-compose-inference-gpu.yml up -d --build

for china user:

docker compose -f inference/docker-compose-inference-gpu.yml -f inference/docker-compose-inference-gpu-cn.yml up -d --build

Getting Started

1. Check out the examples/ directory for usage examples
2. Configure your providers in a YAML config file
3. Run your voice agent application

For detailed configuration and usage guide, see the documentation.

Project Status

Current Version: v0.1.0 (Alpha)

Note: This project is under active development. APIs may change.

License

MIT License - see LICENSE for details.