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/embeddings`	ベクトル埋め込みストレージと類似度検索
`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/migration`	データベーススキーママイグレーション
`wippy/security`	アクタースコープ、ポリシーバンドル、セキュリティヘルパー
`wippy/usage`	LLM 呼び出しのトークンおよびコスト使用量の集計

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

wippy search wippy

Framework

Framework

Adding Framework Modules

Declaring Dependencies in Source

Importing Framework Libraries

Available Modules

See Also