This project is officially supported on Ubuntu 14.04. Other Linux distributions may be able to run this sample.
Refer to the Assistant SDK documentation for more information.
If you have not setup this project before, you can skip this step.
sudo apt-get purge libc-ares-dev # https://github.com/grpc/grpc/pull/10706#issuecomment-302775038
sudo apt-get purge libprotobuf-dev libprotoc-dev
sudo rm -rf /usr/local/bin/grpc_* /usr/local/bin/protoc \
/usr/local/include/google/protobuf/ /usr/local/include/grpc/ /usr/local/include/grpc++/ \
/usr/local/lib/libproto* /usr/local/lib/libgpr* /usr/local/lib/libgrpc* \
/usr/local/lib/pkgconfig/protobuf* /usr/local/lib/pkgconfig/grpc* \
/usr/local/share/grpc/
- Clone this project
git clone https://github.com/googlesamples/assistant-sdk-cpp.git
cd assistant-sdk-cpp
export PROJECT_PATH=$(pwd)
- Install dependencies
sudo apt-get install autoconf automake libtool build-essential curl unzip pkg-config
sudo apt-get install libasound2-dev # For ALSA sound output
sudo apt-get install libcurl4-openssl-dev # CURL development library
- Build Protocol Buffer, gRPC, and Google APIs
git clone -b $(curl -L https://grpc.io/release) https://github.com/grpc/grpc
GRPC_PATH=${PROJECT_PATH}/grpc
cd ${GRPC_PATH}
git submodule update --init
cd third_party/protobuf
./autogen.sh && ./configure && make
sudo make install
sudo ldconfig
export LDFLAGS="$LDFLAGS -lm"
cd ${GRPC_PATH}
make clean
make
sudo make install
sudo ldconfig
cd ${PROJECT_PATH}
git clone https://github.com/googleapis/googleapis.git
cd googleapis/
git checkout 980cdfa
make LANGUAGE=cpp
- Make sure you setup environment variable
$GOOGLEAPIS_GENS_PATH
export GOOGLEAPIS_GENS_PATH=${PROJECT_PATH}/googleapis/gens
- Build this project
cd ${PROJECT_PATH}
make run_assistant
- Get credentials file. It must be an end-user's credentials.
- Go to the Actions Console and register your device model, following these instructions
- Move it in this folder and rename it to
client_secret.json - run
get_credentials.shin this folder. It will create the filecredentials.json.
- Start one of the
run_assistantsamples:
./run_assistant_file --input ./resources/weather_in_mountain_view.raw --output ./response.wav --credentials ./credentials.json
aplay ./response.wav --rate=16000 --format=S16_LEOn a Linux workstation, you can alternatively use ALSA for audio input:
./run_assistant_audio --credentials ./credentials.jsonYou can use a text-based query instead of audio. This allows you to continually enter text queries to the Assistant.
./run_assistant_text --credentials ./credentials.jsonThis takes input from cin, so you can send data to the program when it starts.
echo "what time is it" | ./run_assistant_text --credentials ./credentials.jsonTo change the locale, include a locale parameter:
echo "Bonjour" | ./run_assistant_text --credentials ./credentials.json --locale "fr-FR"Default Assistant gRPC API endpoint is embeddedassistant.googleapis.com. If you want to test with a custom Assistant gRPC API endpoint, you can pass --api_endpoint CUSTOM_API_ENDPOINT.
To get a visual output from the Assistant, provide a command to be run alongside every step of the conversation. It will execute that command along along with a provided argument of a temporary HTML file.
echo "what time is it" | ./run_assistant_text --credentials ./credentials.json --html_out google-chromeAfter you enter text, it will run google-chrome /tmp/google-assistant-cpp-screen-out.html.
If you prefer a different program, use that argument instead.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent