Skip to content

wippyai/framework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wippy logo

Framework

Latest Release License Documentation

A comprehensive monorepo of essential Lua components that expose Wippy's core functionality and abstractions. Provides the foundational building blocks for developing concurrent AI agent applications, including actor model primitives, LLM integration, HTTP services, data storage, security, and configuration management — enabling developers to build sophisticated multiagent systems through Wippy's configuration-driven architecture.

Modules

Framework Modules

Module Description
actor Implementation of the actor model pattern for Wippy Runtime with state management, message handling, and channel operations
agent Library for running LLM agents with conversation management, tool calling, delegation capabilities, and token usage tracking
bootloader System initialization and component bootstrapping for Wippy Runtime
llm Unified interface for working with large language models, providing text generation, tool calling, and embeddings
migration Database migration system with structured patterns for reliable, reversible schema changes
relay Message relay and routing system for distributed communication
security Authentication, authorization, and access control framework with support for actors, scopes, and policies
terminal Terminal interface and command processing capabilities
test BDD-style testing framework for Lua applications with assertions, lifecycle hooks, and mocking capabilities
views UI view management and rendering system
usage Usage tracking and analytics for system monitoring

Separated Modules

Module Description
session Session management and state persistence
uploads File upload handling and management system
embeddings Vector embeddings and semantic search capabilities

Core Modules

Module Description
http HTTP requests and responses within web server context with headers, query params, and streaming
http_client HTTP client for making requests with various methods, batch operations, and streaming responses
sql Database interface for SQL operations across different engines with queries, transactions, and prepared statements
fs Universal filesystem abstraction layer supporting file operations and multi-backend storage systems
json JSON encoding and decoding between Lua values and JSON strings
yaml YAML encoding and decoding with multiline string support
crypto Cryptographic functions including encryption, HMAC, JWT handling, and security utilities
logger Structured logging interface with different log levels and contextual fields
process Actor-model API for concurrent processing with message passing and supervision
channel Go-like channel system for coroutine communication and synchronization
events Channel-based API for subscribing to Wippy event bus system
registry Distributed registry system for querying and managing entries with versioning
store Key-value store interface supporting various backends with TTL support
time Comprehensive time utilities for dates, timers, durations, and timezone handling
uuid UUID generation, validation, and manipulation across different versions
hash Cryptographic and non-cryptographic hash functions (MD5, SHA, FNV)
base64 Base64 encoding and decoding for string conversion
excel Excel file manipulation with workbook operations and sheet management
templates Template rendering system with variable substitution
jet Jet templating system with inheritance patterns
websocket WebSocket client implementation for real-time communication
system Go runtime information access including memory statistics and garbage collection
exec External process execution with input/output streams and process control
env Environment variable access interface
ctx Shared context system for component communication
funcs Task execution interface with async support and cancellation
stream Data streaming interface with chunked reading support
cloudstorage Cloud storage provider interface for S3-like operations

About

Wippy Framework components

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages