TypeScript-first AI gateway fork of Moltis with a real-time chat UI, WebSocket RPC, SQLite session storage, and optional Redis tooling.

This README is intentionally fork-specific and focused on what you can run today in this repo.

• TypeScript gateway runtime under src/gateway/
• Existing Preact UI retained and integrated
• SQLite-backed sessions and chat history
• OpenAI streaming chat in the new gateway
• Optional Redis helper under src/redis/
• Clear migration path from Rust workspace to full TS stack

npm install
cp .env.example .env
# set OPENAI_API_KEY in .env
npm run build:web
npm start

Open: http://127.0.0.1:8080

flowchart LR
  UI[Preact Web UI] --> WS[WebSocket RPC /ws/chat]
  UI --> HTTP[REST /api/*]
  WS --> GW[TypeScript Gateway src/gateway]
  HTTP --> GW
  GW --> DB[(SQLite)]
  GW --> OAI[OpenAI API]
  GW -. optional .-> REDIS[(Redis helper)]

npm run build:web
npm start

Use this only if you need upstream-only features not migrated yet.

cargo build
cargo run

Copy .env.example and set at least OPENAI_API_KEY.

import { RedisConnectionManager, withRedis } from "moltis/redis";

moltis/
├── src/
│   ├── gateway/          # TypeScript gateway runtime
│   └── redis/            # Optional Redis module
├── tests/redis/          # Vitest tests for Redis module
├── crates/web/ui/        # Existing Preact UI source
├── package.json
├── tsconfig.json
└── docs/internal/
    └── TYPESCRIPT-GATEWAY.md

This fork is migrating from the original Rust workspace to a full TypeScript stack in phases.

• Current migration details: docs/internal/TYPESCRIPT-GATEWAY.md
• crates/ still exists to preserve upstream compatibility while TS features are brought over.

• Blank UI after start: run npm run build:web again.
• Chat returns fallback response: check OPENAI_API_KEY.
• Port in use: change MOLTIS_GATEWAY__PORT in .env.
• Redis tests fail: Redis is optional for runtime; ensure env values are valid when testing Redis-specific code.

PRs are welcome. Keep changes scoped, include verification commands, and call out whether changes target:

• TypeScript gateway (src/gateway)
• Redis tooling (src/redis)
• UI integration (crates/web/ui)
• Migration/docs

MIT. See LICENSE.md.