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/embeddings	Vector embeddings storage and similarity search
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	Frontend host configuration, theming, and config endpoint
wippy/terminal	Terminal UI components
wippy/migration	Database schema migrations
wippy/security	Actor scopes, policy bundles, and security helpers
wippy/usage	Token and cost usage accounting for LLM calls

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