com.rest.huggingface

A non-official HuggingFace RESTful client for the Unity Game Engine.

I am not affiliated with HuggingFace and an account with api access is required.

All copyrights, trademarks, logos, and assets are the property of their respective owners.

Installing

Requires Unity 2021.3 LTS or higher.

The recommended installation method is though the unity package manager and OpenUPM.

Via Unity Package Manager and OpenUPM

Open your Unity project settings
Select the Package Manager
Add the OpenUPM package registry:
- Name: OpenUPM
- URL: https://package.openupm.com
- Scope(s):
  - com.rest.huggingface
  - com.utilities
Open the Unity Package Manager window
Change the Registry from Unity to My Registries
Add the HuggingFace package

Via Unity Package Manager and Git url

Open your Unity Package Manager
Add package from git url: https://github.com/RageAgainstThePixel/com.rest.huggingface.git#upm

Note: this repo has dependencies on other repositories! You are responsible for adding these on your own.

Authentication

There are 4 ways to provide your API keys, in order of precedence:

⚠️ We recommended using the environment variables to load the API key instead of having it hard coded in your source. It is not recommended use this method in production, but only for accepting user credentials, local testing and quick start scenarios.

Pass keys directly with constructor ⚠️
Unity Scriptable Object ⚠️
Load key from configuration file
Use System Environment Variables

Pass keys directly with constructor

var api = new HuggingFaceClient("yourApiKey");

Or create a HuggingFaceAuthentication object manually

var api = new HuggingFaceClient(new HuggingFaceAuthentication("yourApiKey"));

Unity Scriptable Object

You can save the key directly into a scriptable object that is located in the Assets/Resources folder.

You can create a new one by using the context menu of the project pane and creating a new HuggingFaceConfiguration scriptable object.

Load key from configuration file

Attempts to load api keys from a configuration file, by default .huggingface in the current directory, optionally traversing up the directory tree or in the user's home directory.

To create a configuration file, create a new text file named .huggingface and containing the line:

Json format

{
  "apiKey": "yourApiKey",
}

You can also load the file directly with known path by calling a static method in Authentication:

var api = new HuggingFaceClient(new HuggingFaceAuthentication().LoadFromDirectory("your/path/to/.huggingface"));;

Use System Environment Variables

Use your system's environment variables specify an api key to use.

Use HUGGING_FACE_API_KEY for your api key.

var api = new HuggingFaceClient(new HuggingFaceAuthentication().LoadFromEnvironment());

Hub

TODO

Inference

TODO

rageagainstthepixel / com.rest.huggingface Goto Github PK