# py-active-call-cc

Python Active-Call: real-time audio streaming with WebSocket and WebRTC.

This repo contains a Python 3.11+ codebase for building low-latency voice
pipelines (capture, stream, and process audio) using WebRTC and WebSockets.
It is currently in an early, experimental stage.

# Usage

启动

```
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

使用 agent profile（推荐）

```
python -m app.main --agent-profile default
```

使用指定 YAML

```
python -m app.main --agent-config config/agents/default.yaml
```

Agent 配置路径优先级
1. `--agent-config`
2. `--agent-profile`（映射到 `config/agents/<profile>.yaml`）
3. `AGENT_CONFIG_PATH`
4. `AGENT_PROFILE`
5. `config/agents/default.yaml`（若存在）

说明
- Agent 相关配置是严格模式：YAML 缺少必须项会直接报错，不会回退到 `.env` 或代码默认值。
- 如果要引用环境变量，请在 YAML 显式写 `${ENV_VAR}`。
- `siliconflow` 独立 section 已移除；请在 `agent.llm / agent.tts / agent.asr` 内通过 `provider`、`api_key`、`api_url`、`model` 配置。

测试

```
python examples/test_websocket.py
```

```
python mic_client.py
```

## WS Protocol

`/ws` uses a strict `v1` JSON control protocol with binary PCM audio frames.

See `docs/ws_v1_schema.md`.