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	Configuracao de host de frontend, tematizacao e endpoint de config
wippy/terminal	Terminal UI components
wippy/security	Escopos de ator, bundles de policy e helpers de seguranca
wippy/usage	Contabilizacao de tokens e custos para chamadas de 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