Files
google--adk-python/contributing/samples/live/live_agent_api_server_example
wehub-resource-sync ec2b666284
Continuous Integration / Pre-commit Linter (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.10) (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.11) (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.12) (push) Waiting to run
Continuous Integration / Mypy Check (Python 3.13) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.10) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.11) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.12) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.13) (push) Waiting to run
Continuous Integration / Unit Tests (Python 3.14) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.10) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.11) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.12) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.13) (push) Waiting to run
Continuous Integration / A2A v0.3 Tests (Python 3.14) (push) Waiting to run
Copybara PR Handler / close-imported-pr (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 13:25:13 +08:00
..

What's this?

This is a sample that shows how to start the ADK api server, and how to connect your agents in a live(bidi-streaming) way. It works text and audio input, and the response is always audio.

Prerequisite

Instruction for this sample

  • The audio libraries we used here doesn't have noise cancellation. So the noise may feed back to the model. You can use headset to avoid this or tune down voice volume, or implement your own noise cancellation logic.
  • Please ensure you grant the right mic/sound device permission to the terminal that runs the script. Sometimes, terminal inside VSCode etc doesn't really work well. So try native terminals if you have permission issue.
  • start api server first for your agent folder. For example, my agents are located in contributing/samples. So I will run adk api_server contributing/samples/. Keep this running.
  • then in a separate window, run python3 live_agent_example.py

Misc

  • Provide a few pre-recorded audio files for testing.