Woodglue

JSON-RPC 2.0 server with auto-generated docs, built on lythonic.

Architecture

┌─────────────────────────────────────────────────┐
│  woodglue                                       │
│  HTTP server · JSON-RPC · Auth · UI · Docs      │
├─────────────────────────────────────────────────┤
│  lythonic                                       │
│  Namespaces · DAGs · Caching · Triggers         │
└─────────────────────────────────────────────────┘

lythonic provides the core runtime: namespaces for organizing methods, DAG-based orchestration, result caching, and scheduled triggers.

woodglue adds the serving layer: a Tornado HTTP server, JSON-RPC 2.0 dispatch, bearer token authentication, a built-in browser UI, and automatic docs generation (llms.txt, OpenAPI, per-method markdown).

Features

• JSON-RPC 2.0 with multi-namespace routing (billing.create_invoice, analytics.query)
• Auto-generated docs: llms.txt index, per-method markdown, OpenAPI 3.0.3
• Built-in UI for API browsing, trigger management, and DAG visualization
• Bearer token authentication
• Typed async client with auto-resolved return types via x-global-ref
• YAML-driven namespace configuration with per-method tags
• DAG orchestration with scheduled triggers (via lythonic)

Quick Start

pip install woodglue

Define a namespace with methods:

from lythonic.compose.namespace import Namespace
from pydantic import BaseModel

class GreetIn(BaseModel):
    name: str

class GreetOut(BaseModel):
    message: str

def greet(input: GreetIn) -> GreetOut:
    return GreetOut(message=f"Hello, {input.name}!")

ns = Namespace()
ns.register(greet, tags=["api"])

Start the server:

wgl start

Auth is enabled by default. wgl start creates a bearer token on first run but never prints it; use wgl token to see it and wgl token --new to rotate it.

Endpoints:

• POST /rpc -- JSON-RPC 2.0
• GET /docs/llms.txt -- LLM-friendly method index
• GET /docs/openapi.json -- OpenAPI 3.0.3 spec
• GET /ui/ -- browser UI

Documentation

walnutgeek.github.io/woodglue