Api-Interfaces is the gRPC protocol for communication between the
api-bridge, the api-web,
and the generator_server. Additionally, any
other client application communicating directly with api-web also use the interfaces generated
from this repository.
These instructions will get you an environment setup to build the interface files from the proto source files.
The following items are needed to develop api-interfaces:
It is recommended to use ssh cloning with this project for git and for go get, although https
does appear to work. To force ssh (for github) put the following in your .gitconfig:
[url "ssh://git@github.com/"]
insteadOf = https://github.com/After all the prerequisites are installed and available, this project can be setup by the following:
git clone --recurse-submodules git@github.com:Stability-AI/api-interfaces.git
cd api-interfaces
cmake .
cmake --build .This will produce files for the various languages in gooseai to support the proto files in src. When rebuilding the files it is recommended to do a clean before as there have been instances of not all files being regenerated without it.
The generated files are all output in gooseai. How to use these files depends on the programming language being used. The following sections provide details for each of the supported languages.
The files have different usages and not all are required depending on the situation:
| Suffix | Client | Server |
|---|---|---|
| _grpc_pb | ✔️1 | ✔️ |
| _pb_service | ✔️2 | |
| _pb | ✔️ | ✔️ |
- Not needed for typescript/javascript clients.
- Only needed for typscript/javascripts clients.
For Golang the interfaces can be added to the project as a normal module require. To add them run:
go get github.com/Stability-AI/api-interfaces@latestSimilarly to update them just run the same command with the short sha of the version to update to. Use them as you would a normal module.
With the current output, the best way to consume these is to add them as a git submodule to your project. It is recommended to use ssh clone when adding the submodule. To update them just checkout the newer version from within the submodule (and remember to commit the submodule change to your project).
To use them make sure the files are on the python path.
With the current output, the best way to consume these is to add them as a git submodule to your project. It is recommended to use ssh clone when adding the submodule. To update them just checkout the newer version from within the submodule (and remember to commit the submodule change to your project).
To use them make sure they are in a location that can be found by your typescript/javascript files.
NOTE: Typescript requires both the typescript and javascript files to be available.
If not using the CMake defined builds to generate make sure when building from the source proto files that the following proto include paths are set:
src/protosrc/tensorizer/proto