string_therapy

JWT-gated LLM controller that routes messages over PostgreSQL + Apache AGE and forwards to downstream HTTP endpoints

string_therapy is a FastHTML service: Lisette browses category/endpoint strings from an AGE routing graph (ACL-filtered by JWT), or routes and forward_tools when the user is ready — asking for any missing required parameters first.

Quickstart

Install

pip install string-therapy
# or editable: pip install -e .
# or from git: pip install git+https://github.com/alix559/string_therapy.git

Configure

Copy .env.example to .env and set at least:

• ROUTER_DATABASE_URL — Postgres DSN with Apache AGE available
• LISETTE_MODEL + LISETTE_API_KEY (or OPENAI_API_KEY)
• JWT_SECRET (or JWT_AUTH_DISABLED=true for local dev)

Schema → seed → serve

string-therapy-ensure-schema
string-therapy-seed --graph examples/router_graph.json
string-therapy-serve

Or in Python:

from string_therapy import ensure_schema, seed_router_db, create_app, serve_controller

ensure_schema()
seed_router_db('examples/router_graph.json')
serve_controller()  # or: app = create_app()

Call the API

curl -s http://127.0.0.1:5011/health

curl -s http://127.0.0.1:5011/controller \
  -H 'Authorization: Bearer <jwt>' \
  -H 'Content-Type: application/json' \
  -d '{"message": "run a sales report"}'

JWT claims: sub (required), optional roles / groups. Those map to ACL principals like role:analyst.

Router graph JSON

See examples/router_graph.json (also packaged under string_therapy/examples/). Nodes are categories or endpoints with intent (stable key) and name (display label); edges are SERVES; optional acl rows set (node_id, principal, permission).

Example notebook

Walk through the library interactively:

jupyter notebook examples/getting_started.ipynb

Developer Guide

This project uses nbdev. Edit notebooks under nbs/, then:

pip install -e ".[dev]"
nbdev_prepare
pytest -q

Documentation

• Docs: https://alix559.github.io/string_therapy/
• Repo: https://github.com/alix559/string_therapy