Skip to content

feat: introduce 'Local-First' skill packaging with embedded runtime for air-gapped deployment #535

Description

@FenjuFu

Motivation

The current GitHub Trending landscape (2026-06-17) is dominated by a strong shift towards Data Sovereignty and Self-Hosted Infrastructure. Projects like teslamate-org/teslamate (+215 stars today) and alibaba/zvec (+156 stars today) highlight a critical pain point: enterprises are increasingly rejecting cloud-dependent AI stacks in favor of local-first, low-latency, and fully controllable solutions.

While alibaba/zvec addresses the inference layer by providing a lightweight, in-process vector DB, the execution layer (Skills/Agents) remains fragmented. Many enterprise environments (finance, government, healthcare) require strict air-gapped deployments where skills cannot reach out to external registries or rely on dynamic cloud dependencies during execution. Currently, iflytek/skillhub supports self-hosting, but the skill packaging format assumes a degree of network connectivity or external runtime resolution.

Proposed feature

I propose adding support for Offline-First Skill Packaging with an Embedded Runtime within the SkillHub protocol. This would allow skills to be packaged as self-contained artifacts (e.g., .skill bundles) that include:

  1. Embedded Dependencies: All Python wheels, static assets, and configuration files required for execution are bundled within the skill package.
  2. Local-First Execution Context: The SkillHub engine detects if the environment is air-gapped and switches to a local-only execution mode, bypassing any external API calls or registry checks during skill invocation.
  3. Version Pinning & Integrity: Ensure that the embedded runtime versions are strictly pinned to prevent drift, similar to how zvec ensures consistency by being in-process.

This feature would enable enterprises to distribute and update skills via secure, offline channels (e.g., USB transfer, internal artifact repositories) without compromising security or functionality.

Why it fits this repo

iflytek/skillhub is positioned as the "enterprise-grade skill registry." To truly serve the "Data Sovereignty" trend highlighted by today's trending repos, it must support complete offline lifecycle management.

  • Unlike teslamate which stores local data, SkillHub needs to store and distribute executable logic locally.
  • Unlike zvec which is a library, SkillHub is the distribution mechanism. Adding offline-first packaging makes it the missing link for fully self-hosted AI agent ecosystems.

This aligns with the growing demand for "Zero-Dependency" or "Low-Maintenance" infrastructure, allowing enterprises to deploy AI agents that are as robust and isolated as local-first databases.

References

  • alibaba/zvec: Demonstrates the trend towards lightweight, in-process, zero-dependency AI infrastructure.
  • teslamate-org/teslamate: Highlights the user demand for self-hosted, data-local solutions to avoid cloud dependency.
  • n0-computer/iroh: Shows the viability of ID-based, decentralized networking for resilient, offline-capable systems.

Metadata

Metadata

Assignees

No one assigned

    Labels

    effort/s小改动或边界明确 / Small or well-bounded change.priority/p2中优先级 / Medium priority triage bucket.triage/needs-info需要补充更多信息后才能分流 / Issue needs more detail before it can be routed.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions