Framework

Framework

Wippy provides official framework modules through the hub. These modules are maintained under the wippy organization and can be added to any project.

Adding Framework Modules

wippy add wippy/test
wippy install

This adds the module to your lock file and downloads it to .wippy/vendor/.

Declaring Dependencies in Source

Framework modules can also be declared as dependencies in your _index.yaml:

version: "1.0"
namespace: app

entries:
  - name: dependency.test
    kind: ns.dependency
    component: wippy/test
    version: "^0.3.0"

Then resolve and install:

wippy update

Importing Framework Libraries

Once installed, import framework libraries into your entries:

entries:
  - name: my_test
    kind: function.lua
    meta:
      type: test
      suite: my-suite
    source: file://my_test.lua
    method: run
    imports:
      test: wippy.test:test

The import maps wippy.test:test (the test entry from the wippy.test namespace) to the local name test, which you then require("test") in Lua.

Available Modules

Module	Description
wippy/llm	Unified LLM interface with generation, streaming, tool calling, structured output
wippy/agent	Agent framework with tools, delegates, traits, and memory
wippy/test	BDD-style testing framework with assertions and mocking
wippy/dataflow	Workflow orchestration with DAG-based node execution
wippy/relay	WebSocket relay with per-user hubs and plugin routing
wippy/views	Virtual page/component system with template rendering
wippy/facade	前端宿主配置、主题化和配置端点
wippy/terminal	Terminal UI components
wippy/security	行为者作用域、策略包和安全辅助工具
wippy/usage	LLM 调用的令牌和成本使用核算

More modules are available and being published regularly. Search the hub:

wippy search wippy

See Also

• Dependency Management - Lock file and version constraints
• Publishing - Publishing your own modules
• CLI Reference - CLI commands