Kumiho Python SDK

User Guide

  • Getting Started
    • Installation
    • Authentication
      • Using the CLI
      • Programmatic Authentication
    • Basic Concepts
      • Projects
      • Spaces
      • Items
      • Revisions
      • Artifacts
      • Edges
      • Bundles
    • Kref URIs
    • Error Handling
    • Best Practices
    • AI Assistant Integration (MCP)
      • Quick Setup
    • Next Steps
  • Core Concepts
    • Graph-Native Architecture
    • Entity Hierarchy
      • Project
      • Space
      • Item
      • Revision
      • Artifact
      • Edge
      • Graph Traversal
      • Bundle
    • Metadata
      • Setting Metadata
      • Granular Attribute Operations
      • Common Metadata Patterns
    • Kref URI Scheme
    • Time-Based Revision Queries
      • Why Time-Based Queries Matter
      • Using get_revision_by_time
      • Time-Based Kref URIs
      • Practical Examples
      • Tags and Time
    • BYO Storage Philosophy
    • Multi-Tenant Architecture
    • Event Streaming
      • Basic Usage
      • Event Object
      • Event Types (Routing Keys)
      • Tier-Based Capabilities
      • Query Tier Capabilities
      • Resumable Streaming (Coming Soon - Creator+)
      • Replay from Beginning (Coming Soon - Creator+)
      • Feature-Gated Streaming
      • Use Cases by Tier
    • Next Steps
  • Authentication
    • Overview
    • CLI Authentication
      • Cached Credentials
      • Refreshing Tokens
    • Programmatic Authentication
      • With Firebase ID Token
      • With Environment Variables
    • Future Authentication Methods
    • Discovery Flow
      • Discovery Response
    • Token Refresh
    • Multiple Tenants
    • Environment Variables
    • Security Best Practices
    • Troubleshooting
      • Token Expired
      • Invalid Tenant
      • Connection Failed
    • Next Steps
  • MCP Server Integration
    • What is MCP?
    • Installation
    • Authentication
    • Running the MCP Server
      • Standalone Mode
      • VS Code / GitHub Copilot Integration
      • Claude Desktop Integration
    • Available Tools
      • Read Operations (14 tools)
      • Graph Traversal (5 tools)
      • Create Operations (8 tools)
      • Delete Operations (6 tools)
      • Update Operations (6 tools)
    • Example Conversations
      • Exploring Assets
      • Dependency Analysis
      • Asset Management
      • AI Lineage Tracking
    • Kref URI Format
    • Edge Types
    • Environment Variables
    • MCP Resources and Prompts
      • Resources
      • Prompts
    • Troubleshooting
      • Server won’t start
      • Tools not appearing in AI assistant
      • Authentication errors
    • API Reference

API Reference

  • kumiho
    • __version__
    • LATEST_TAG
    • PUBLISHED_TAG
    • KumihoObject
      • KumihoObject._client
      • KumihoObject.__init__()
    • KumihoError
    • Project
      • Project.project_id
      • Project.name
      • Project.description
      • Project.created_at
      • Project.updated_at
      • Project.deprecated
      • Project.allow_public
      • Project.__init__()
      • Project.__repr__()
      • Project.create_bundle()
      • Project.create_item()
      • Project.create_space()
      • Project.delete()
      • Project.get_bundle()
      • Project.get_item()
      • Project.get_space()
      • Project.get_spaces()
      • Project.set_public()
      • Project.update()
    • Space
      • Space.path
      • Space.name
      • Space.type
      • Space.created_at
      • Space.author
      • Space.metadata
      • Space.username
      • Space.__init__()
      • Space.__repr__()
      • Space.create_bundle()
      • Space.create_item()
      • Space.create_space()
      • Space.delete()
      • Space.delete_attribute()
      • Space.get_attribute()
      • Space.get_bundle()
      • Space.get_child_spaces()
      • Space.get_item()
      • Space.get_items()
      • Space.get_parent_space()
      • Space.get_project()
      • Space.get_space()
      • Space.get_spaces()
      • Space.set_attribute()
      • Space.set_metadata()
    • Item
      • Item.kref
      • Item.name
      • Item.item_name
      • Item.kind
      • Item.created_at
      • Item.author
      • Item.metadata
      • Item.deprecated
      • Item.username
      • Item.__init__()
      • Item.__repr__()
      • Item.create_revision()
      • Item.delete()
      • Item.delete_attribute()
      • Item.get_attribute()
      • Item.get_latest_revision()
      • Item.get_project()
      • Item.get_revision()
      • Item.get_revision_by_tag()
      • Item.get_revision_by_time()
      • Item.get_revisions()
      • Item.get_space()
      • Item.peek_next_revision()
      • Item.set_attribute()
      • Item.set_deprecated()
      • Item.set_metadata()
    • Revision
      • Revision.kref
      • Revision.item_kref
      • Revision.number
      • Revision.latest
      • Revision.tags
      • Revision.metadata
      • Revision.created_at
      • Revision.author
      • Revision.deprecated
      • Revision.published
      • Revision.username
      • Revision.default_artifact
      • Revision.__init__()
      • Revision.__repr__()
      • Revision.analyze_impact()
      • Revision.create_artifact()
      • Revision.create_edge()
      • Revision.delete()
      • Revision.delete_attribute()
      • Revision.delete_edge()
      • Revision.find_path_to()
      • Revision.get_all_dependencies()
      • Revision.get_all_dependents()
      • Revision.get_artifact()
      • Revision.get_artifacts()
      • Revision.get_attribute()
      • Revision.get_edges()
      • Revision.get_item()
      • Revision.get_locations()
      • Revision.get_project()
      • Revision.get_space()
      • Revision.has_tag()
      • Revision.refresh()
      • Revision.set_attribute()
      • Revision.set_default_artifact()
      • Revision.set_deprecated()
      • Revision.set_metadata()
      • Revision.tag()
      • Revision.tags
      • Revision.untag()
      • Revision.was_tagged()
    • Artifact
      • Artifact.kref
      • Artifact.location
      • Artifact.revision_kref
      • Artifact.item_kref
      • Artifact.created_at
      • Artifact.author
      • Artifact.metadata
      • Artifact.deprecated
      • Artifact.username
      • Artifact.__init__()
      • Artifact.__repr__()
      • Artifact.delete()
      • Artifact.delete_attribute()
      • Artifact.get_attribute()
      • Artifact.get_item()
      • Artifact.get_project()
      • Artifact.get_revision()
      • Artifact.get_space()
      • Artifact.name
      • Artifact.set_attribute()
      • Artifact.set_default()
      • Artifact.set_deprecated()
      • Artifact.set_metadata()
    • Edge
      • Edge.source_kref
      • Edge.target_kref
      • Edge.edge_type
      • Edge.metadata
      • Edge.created_at
      • Edge.author
      • Edge.username
      • Edge.__init__()
      • Edge.__repr__()
      • Edge.delete()
    • Kref
      • Kref.uri
      • Kref.__eq__()
      • Kref.__hash__()
      • Kref.__new__()
      • Kref.__repr__()
      • Kref.from_pb()
      • Kref.get_artifact_name()
      • Kref.get_item_name()
      • Kref.get_kind()
      • Kref.get_path()
      • Kref.get_revision()
      • Kref.get_space()
      • Kref.to_pb()
      • Kref.uri
    • Event
      • Event.routing_key
      • Event.kref
      • Event.timestamp
      • Event.author
      • Event.details
      • Event.cursor
      • Event.__init__()
      • Event.__repr__()
    • ProjectLimitError
    • Bundle
      • Bundle.kref
      • Bundle.name
      • Bundle.item_name
      • Bundle.kind
      • Bundle.metadata
      • Bundle.created_at
      • Bundle.author
      • Bundle.username
      • Bundle.deprecated
      • Bundle.__init__()
      • Bundle.__repr__()
      • Bundle.add_member()
      • Bundle.get_history()
      • Bundle.get_members()
      • Bundle.remove_member()
    • BundleMember
      • BundleMember.item_kref
      • BundleMember.added_at
      • BundleMember.added_by
      • BundleMember.added_by_username
      • BundleMember.added_in_revision
      • BundleMember.__init__()
      • BundleMember.item_kref
      • BundleMember.added_at
      • BundleMember.added_by
      • BundleMember.added_by_username
      • BundleMember.added_in_revision
    • BundleRevisionHistory
      • BundleRevisionHistory.revision_number
      • BundleRevisionHistory.action
      • BundleRevisionHistory.member_item_kref
      • BundleRevisionHistory.author
      • BundleRevisionHistory.username
      • BundleRevisionHistory.created_at
      • BundleRevisionHistory.metadata
      • BundleRevisionHistory.__init__()
      • BundleRevisionHistory.revision_number
      • BundleRevisionHistory.action
      • BundleRevisionHistory.member_item_kref
      • BundleRevisionHistory.author
      • BundleRevisionHistory.username
      • BundleRevisionHistory.created_at
      • BundleRevisionHistory.metadata
    • ReservedKindError
    • KrefValidationError
    • EdgeTypeValidationError
    • validate_kref()
    • validate_edge_type()
    • is_valid_kref()
    • is_valid_edge_type()
    • connect()
    • use_client
      • use_client.__init__()
      • use_client.__enter__()
      • use_client.__exit__()
    • get_client()
    • configure_default_client()
    • auto_configure_from_discovery()
    • LATEST_TAG
    • PUBLISHED_TAG
    • EdgeType
      • EdgeType.BELONGS_TO
      • EdgeType.CREATED_FROM
      • EdgeType.REFERENCED
      • EdgeType.DEPENDS_ON
      • EdgeType.DERIVED_FROM
      • EdgeType.CONTAINS
      • EdgeType.BELONGS_TO
      • EdgeType.CONTAINS
      • EdgeType.CREATED_FROM
      • EdgeType.DEPENDS_ON
      • EdgeType.DERIVED_FROM
      • EdgeType.REFERENCED
    • EdgeDirection
      • EdgeDirection.OUTGOING
      • EdgeDirection.INCOMING
      • EdgeDirection.BOTH
      • EdgeDirection.BOTH
      • EdgeDirection.INCOMING
      • EdgeDirection.OUTGOING
    • get_tenant_info()
    • get_tenant_slug()
    • create_project()
    • get_projects()
    • get_project()
    • delete_project()
    • item_search()
    • get_item()
    • get_bundle()
    • get_revision()
    • get_artifact()
    • get_artifacts_by_location()
    • set_attribute()
    • get_attribute()
    • delete_attribute()
    • event_stream()
    • get_event_capabilities()
    • EventCapabilities
      • EventCapabilities.supports_replay
      • EventCapabilities.supports_cursor
      • EventCapabilities.supports_consumer_groups
      • EventCapabilities.max_retention_hours
      • EventCapabilities.max_buffer_size
      • EventCapabilities.tier
      • EventCapabilities.__init__()
      • EventCapabilities.supports_replay
      • EventCapabilities.supports_cursor
      • EventCapabilities.supports_consumer_groups
      • EventCapabilities.max_retention_hours
      • EventCapabilities.max_buffer_size
      • EventCapabilities.tier
    • resolve()
  • kumiho.project
  • kumiho.space
  • kumiho.item
  • kumiho.bundle
  • kumiho.revision
  • kumiho.artifact
  • kumiho.edge
  • kumiho.kref
  • MCP Server
    • tool_list_projects()
    • tool_get_project()
    • tool_get_spaces()
    • tool_get_space()
    • tool_get_item()
    • tool_get_revision()
    • tool_get_artifacts()
    • tool_get_artifact()
    • tool_get_bundle()
    • tool_search_items()
    • tool_get_dependencies()
    • tool_get_dependents()
    • tool_analyze_impact()
    • tool_find_path()
    • tool_get_edges()
    • tool_resolve_kref()
    • tool_get_artifacts_by_location()
    • tool_get_item_revisions()
    • tool_get_revision_by_tag()
    • tool_create_revision()
    • tool_tag_revision()
    • tool_create_edge()
    • tool_create_project()
    • tool_create_space()
    • tool_create_item()
    • tool_create_artifact()
    • tool_create_bundle()
    • tool_delete_project()
    • tool_delete_space()
    • tool_delete_item()
    • tool_delete_revision()
    • tool_delete_artifact()
    • tool_delete_edge()
    • tool_untag_revision()
    • tool_set_metadata()
    • tool_deprecate_item()
    • tool_add_bundle_member()
    • tool_remove_bundle_member()
    • tool_get_bundle_members()
    • create_mcp_server()
    • run_server()
    • main()
    • Tool Definitions

Development

  • Changelog
    • [0.4.0] - 2025-12-03
      • Added
      • Changed
      • Notes
    • [0.3.0] - 2024-XX-XX
      • Added
      • Changed
      • Fixed
    • [0.2.0] - 2024-XX-XX
      • Added
      • Changed
    • [0.1.0] - 2024-XX-XX
      • Added
  • Contributing
    • Development Setup
    • Code Style
    • Documentation
    • Testing
    • Pull Request Process
    • License
Kumiho Python SDK
  • Search

© Copyright 2025, Kumiho Clouds.

Built with Sphinx using a theme provided by Read the Docs.