Kumiho Client SDKs

Build custom integrations and automate your pipeline with our open-source SDKs. Available for Python, C++, Dart, and FastAPI for web backends.

🐍 Python SDK

For pipeline tools, automation scripts, and data processing workflows

Installation

pip install -e ../kumiho-python/python

# Authenticate (first time)

kumiho-auth login

Key Features

Automatic authentication with Firebase
Discovery-based tenant routing
Full gRPC API access
Token refresh handling
Comprehensive pytest harness

Quickstart

# Auto-configure from discovery

from kumiho import client_from_discovery


client = client_from_discovery()


# Create a project

project = client.create_group("my-project")


# Upload an asset

resource = client.create_resource(

path="/my-project/scene.blend",

file_path="./scene.blend"

)

Common Use Cases

Pipeline Automation
Automate asset versioning in render pipelines
Batch Processing
Process and upload multiple assets programmatically
CI/CD Integration
Integrate with build systems and deployment workflows

⚡ C++ SDK

For high-performance plugins and native integrations with DCC tools

Installation

# Clone the repository

git clone https://github.com/kumihoclouds/KumihoSaaS

cd kumiho-cpp


# Build with CMake

cmake -B build

cmake --build build

Key Features

Zero-copy binary transfers
Native gRPC performance
Cross-platform support
Minimal dependencies
Thread-safe operations

Quickstart

#include

<kumiho/client.h>

int main() {

// Initialize client

kumiho::Client client;


// Create a project

auto project = client.create_group(

"my-project"

);


return 0;

}

Common Use Cases

DCC Plugins
Build native plugins for Maya, Blender, Houdini
Game Engines
Integrate with Unreal Engine and Unity
High-Performance Tools
Build custom tools requiring maximum performance

🎯 Dart SDK

For cross-platform mobile and desktop applications with Flutter

Installation

# Add to pubspec.yaml

dependencies:

kumiho:

path: ../kumiho-dart


# Install dependencies

flutter pub get

Key Features

Flutter-ready widgets
Async/await API
Cross-platform (iOS, Android, Web, Desktop)
Reactive state management
Built-in caching

Quickstart

import 'package:kumiho/kumiho.dart';


void main() async {

// Initialize client

final client = KumihoClient();


// Create a project

final project = await client.createGroup(

'my-project',

);


print('Created: $${project.path}');

}

Common Use Cases

Mobile Apps
Build iOS and Android apps for asset management
Desktop Tools
Create cross-platform desktop applications
Web Dashboards
Build responsive web interfaces with Flutter

🚀 FastAPI SDK

Backend-For-Frontend service for web applications and REST APIs

Installation

# Install dependencies

pip install -r requirements.txt

pip install -e ../kumiho-python/python


# Authenticate

kumiho-auth login


# Run the server

uvicorn app.main:app --reload

Key Features

Auto-configured Kumiho client
Pass-through authentication
Automatic token refresh
OpenAPI documentation
Production-ready deployment

Quickstart

from fastapi import FastAPI

from kumiho import Client


app = FastAPI()

client = Client() # Auto-configured


# Pass-through authentication

@app.post("/api/projects")

async def create_project(

token: str,

name: str

):

return client.create_project(

name, user_token=token

)

Common Use Cases

Web Backends
Build REST APIs for web applications
Microservices
Create scalable backend services
API Gateways
Proxy and transform Kumiho API for clients