ForjioHuudisIdentityPlugipayPaymentsStorlaunchE-commerceFulkrumaFulfilmentRiplloMarketingLinkSnapShort URLsPawpadoGPU streamingCatentioAgent runtime
Huudis Docs
⌘K

Installation

Huudis ships three flavors of tooling. Pick the one that fits how you work:

  • SDK — libraries in Node.js, Python, and Go. Best for embedding Huudis sign-in or admin calls in an application.
  • CLI — huudis on your terminal. Best for one-off operations, scripting, and exploration. Doesn't require a project.
  • Raw API — if you can't or don't want to add a dependency, the REST API is fully documented.

This page covers installing the SDKs. The CLI install is covered alongside the CLI authentication topic.

Node.js SDK

Published on npm as @forjio/huudis-node. Install it as a runtime dependency:

npm install @forjio/huudis-node

The minimum Node.js version is 20. Verify the install:

node -e "import('@forjio/huudis-node').then(m => console.log(Object.keys(m)))"

You should see exports including HuudisClient, verifyAccessToken, and verifyWebhookSignature.

TypeScript? The package ships with first-class types. There's nothing to install separately — just import { HuudisClient } from '@forjio/huudis-node' and your editor will pick up everything.

The next step is following the Node SDK overview to authenticate the client.

Python SDK

Published on PyPI as huudis. Install it with pip:

pip install huudis

The minimum Python version is 3.9. Verify the install:

python -c "from huudis import HuudisClient; print(HuudisClient)"

The package exposes a sync API (HuudisClient) and an async API (AsyncHuudisClient) — pick whichever matches your application style.

Poetry or uv user? poetry add huudis and uv add huudis both work — there's no extra configuration.

Go SDK

Published on Go modules at github.com/hachimi-cat/huudis-go. Add it to your module:

go get github.com/hachimi-cat/huudis-go@latest

The minimum Go version is 1.22. Verify the install:

package main

import (
    "fmt"
    huudis "github.com/hachimi-cat/huudis-go"
)

func main() {
    fmt.Println(huudis.SDKVersion)
}

CLI

The CLI is published on npm as @forjio/huudis-cli. Install it globally:

npm install -g @forjio/huudis-cli

Verify:

huudis --version

The CLI authenticates over OIDC device flow — huudis auth login prints a short code and a URL; you approve it from any browser already signed into Huudis. See OIDC overview for the wire details.

What's next