BlonDev / perspectiveapi-simple-server

A simple nodejs server to allow controlled access to the Perspective API

A Simple Server for the Perspective API

A simple demo server for use. It serves some static content from a specified directory, and provides proxy to the API in a way that enables the API-key to be kept private.

Quickly trying it out

# Install dependencies
yarn install
# Make sure the build directory is setup (has at least a copy of the template config)
yarn run setup
# Build the code (in build/)
yarn run build
# Start a dev server locally on port 8080
yarn run start-dev

Now you can visit http://localhost:8080/ and you should get a "hello world!" page.

Configuring the server

To configure the server, create a server_config.json file with the following fields.

• "port": The port to run on. The default is 8081 for development and 8080 for production if this is left empty.

• "staticPath": The path where the static html/css/js resources are located. Note that this path is relative to the directory of the run_server.js file, which is in you projects node_modules node_modules/@conversationai/perspectiveapi-simple-server/build/server/run_server.js

• "googleCloudApiKey": The API key for your google cloud project.

• "toxicityAttribute": The name of the attribute to use for toxicity scores. See the PerspectiveAPI documentation for more details.

Note: The following can be done with npm as well as yarn, but yarn is recommended.

To use this server, run:

yarn add @conversationai/perspectiveapi-simple-server
yarn install

This will add the server to your node_modules folder.

Then, to run the server, call:

node node_modules/@conversationai/perspectiveapi-simple-server/build/server/run_server.js server_config.json

Notes

This is example code to help experimentation with the Perspective API; it is not an official Google product.