kumiho library

Kumiho Dart SDK - A graph-native creative and AI asset management client.

This library provides a Dart client for the Kumiho Cloud gRPC service. Kumiho tracks revisions, relationships, and lineage of creative assets without uploading files to the cloud (BYO Storage philosophy).

Getting Started

import 'package:kumiho/kumiho.dart';

void main() async {
  // Token is auto-loaded from env var or ~/.kumiho/kumiho_authentication.json
  final client = KumihoClient(
    host: 'localhost',
    port: 50051,
  );

  try {
    // Create a project
    final project = await client.newProject('my-project');

    // Create a space using fluent API
    final space = await project.createSpace('models');

    // Create an item
    final item = await space.createItem('hero', 'model');

    // Create a revision
    final revision = await item.createRevision();

    // Add an artifact
    await revision.createArtifact('mesh', '/path/to/hero.fbx');

  } finally {
    await client.shutdownAsync();
  }
}

Authentication

The SDK supports multiple authentication methods:

1. Explicit token: Pass token parameter to constructor
2. Environment variable: Set KUMIHO_AUTH_TOKEN
3. Credentials file: Use kumiho-cli login to cache credentials at ~/.kumiho/kumiho_authentication.json

Auto-Refresh (Opt-in)

Set KUMIHO_ENABLE_AUTO_REFRESH=true to enable automatic token refresh when credentials expire. The SDK will use the stored refresh token.

Environment Variables

Key Concepts

• Project: Top-level container for all assets and spaces
• Space: Hierarchical folder structure within a project
• Item: A versioned asset (model, texture, workflow, etc.)
• Revision: A specific iteration of an item with artifacts
• Artifact: A file reference (path/URI) within a revision
• Edge: A relationship between revisions (dependencies, references)
• Bundle: A special item that aggregates other items
• Kref: A URI-based unique identifier for any Kumiho object