gaproxy is a lightweight HTTP proxy server that acts as a gateway to the Google Assistant Service (gRPC) API.

It accepts HTTP POST requests containing text commands (e.g., "Turn on the light"), forwards them to Google Assistant via gRPC, and returns the result text.

This tool is designed for Headless Smart Home Control. It is not a conversational chatbot. It is intended to trigger Google Assistant actions (like controlling lights, checking weather, or broadcasting messages) from systems that cannot run the heavy Assistant SDK natively.

You need the following credentials obtained from your Google Cloud / Actions Console project:

• OAuth2 Client ID
• OAuth2 Client Secret
• OAuth2 Refresh Token (authorized for https://www.googleapis.com/auth/assistant-sdk-prototype)
• Device Model ID (registered in the Actions Console)
• Device ID (any unique string)

The application is configured entirely via environment variables.

docker run -d -p 8080:8080 \
  -e GAPROXY_CLIENT_ID="your-client-id" \
  -e GAPROXY_CLIENT_SECRET="your-client-secret" \
  -e GAPROXY_REFRESH_TOKEN="your-refresh-token" \
  -e GAPROXY_DEVICE_ID="default" \
  -e GAPROXY_DEVICE_MODEL_ID="default" \
  -e GAPROXY_LANGUAGE_CODE="en-US" \
  ghcr.io/hnw/gaproxy:latest

Example docker-compose.yml:

services:
  gaproxy:
    image: ghcr.io/hnw/gaproxy:latest
    ports:
      - "8080:8080"
    environment:
      - GAPROXY_CLIENT_ID=${GAPROXY_CLIENT_ID}
      - GAPROXY_CLIENT_SECRET=${GAPROXY_CLIENT_SECRET}
      - GAPROXY_REFRESH_TOKEN=${GAPROXY_REFRESH_TOKEN}
      - GAPROXY_DEVICE_ID=default
      - GAPROXY_DEVICE_MODEL_ID=default
      - GAPROXY_LANGUAGE_CODE=en-US
    restart: always

Send a text command via HTTP POST. The command is treated as a "New Conversation" every time (context is not preserved).

Example: Control devices

curl -X POST -d "Turn on the light" http://localhost:8080

Example: Broadcast

curl -X POST -d "Broadcast breakfast is ready" http://localhost:8080

• Broadcast not working: If the "broadcast" command doesn't work, ensure your device (represented by the Model ID) is added to a "Home" in the Google Home app.
• Changing Language: The language setting is fixed at container startup. If you want to send Japanese commands, you must set GAPROXY_LANGUAGE_CODE=ja-JP.

Apache License 2.0